List ECOs

GET

/ecos

curl --request GET \
  --url https://app.buildtrace.eu/api/ecos \
  --header 'Authorization: Bearer <token>'

Required scope: ecos:read.

Authorizations

• bearerAuth

Parameters

Query Parameters

status

string

Comma-separated statuses to include (e.g. DRAFT,APPROVED). Absent = all.

limit

integer

offset

integer

Responses

200

OK

Media typeapplication/json

Array<object>

object

id

required

string format: uuid

revisionId

required

string format: uuid

ecoNumber

required

string

title

required

string

kind

required

string

status

required

string

appliesTo

required

string

effectiveDate

string format: date-time

partCode

Code of the ECO’s part, populated by the org-wide list (read-only).

string

Example ^generated

[
  {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "revisionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "ecoNumber": "example",
    "title": "example",
    "kind": "example",
    "status": "example",
    "appliesTo": "example",
    "effectiveDate": "2026-04-15T12:00:00Z",
    "partCode": "example"
  }
]

401

Unauthorized