Get a unit's timeline

GET

/serials/{id}/timeline

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

Required scope: inventory:read.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

OK

Media typeapplication/json

Array<object>

object

type

required

string

occurredAt

required

string format: date-time

fromStatus

string

toStatus

string

fromLocationId

string format: uuid

toLocationId

string format: uuid

refType

string

refId

What refType names, e.g. the component type of a FIRMWARE_FLASHED event (whose reason is the version).

string format: uuid

reason

string

Example ^generated

[
  {
    "type": "example",
    "occurredAt": "2026-04-15T12:00:00Z",
    "fromStatus": "example",
    "toStatus": "example",
    "fromLocationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "toLocationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "refType": "example",
    "refId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "reason": "example"
  }
]

401

Unauthorized

404

Not found