List devices

GET

/devices

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

Required scope: field:read.

Authorizations

• bearerAuth

Responses

200

OK

Media typeapplication/json

Array<object>

object

id

required

string format: uuid

serialId

required

string format: uuid

fleetId

string format: uuid

serialNumber

The unit’s serial number (on listed and fetched devices).

string

deviceIdentifier

required

string

deploymentStatus

required

string

lastSeenAt

When the device last checked in; absent if it never has.

string format: date-time

connectionStatus

required

string

firmwareCompliant

required

boolean

deploymentLocation

string

customerName

string

Example ^generated

[
  {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "serialId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "fleetId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "serialNumber": "example",
    "deviceIdentifier": "example",
    "deploymentStatus": "example",
    "lastSeenAt": "2026-04-15T12:00:00Z",
    "connectionStatus": "example",
    "firmwareCompliant": true,
    "deploymentLocation": "example",
    "customerName": "example"
  }
]

401

Unauthorized