Skip to content
BuildTrace Docs

Get a revision's effective BOM

GET
/revisions/{id}/bom
curl --request GET \
  --url https://app.buildtrace.eu/api/revisions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/bom \
  --header 'Authorization: Bearer <token>'

Required scope: bom:read.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
effectiveAsOf
string format: date-time

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
revisionId
required
string format: uuid
line
object
id
required
string format: uuid
childPartId
required
string format: uuid
childRevisionId
string format: uuid
refMode
required
string
quantity
required
string
sequence
required
integer
ecoNumber

ECO number that added or replaced this line (absent for base-BOM lines)

string
ecoTitle

Title of the ECO that placed this line

string
ecoEffectiveDate

Effective date of the ECO that placed this line

string format: date-time
children
required
Array<object> recursive

Example generated

{
  "revisionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "line": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "childPartId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "childRevisionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "refMode": "example",
    "quantity": "example",
    "sequence": 1,
    "ecoNumber": "example",
    "ecoTitle": "example",
    "ecoEffectiveDate": "2026-04-15T12:00:00Z"
  },
  "children": []
}

401

Section titled “401”

Unauthorized

404

Section titled “404”

Not found

409

Section titled “409”

Effective ECOs change the same part, or floating lines loop back on themselves

Media typeapplication/json
object
error
required
string

Example generated

{
  "error": "example"
}