Skip to content

Get a device

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

Required scope: field:read.

id
required
string format: uuid

OK

Media typeapplication/json
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"
}

Unauthorized

Not found