FleetbaseFleetbase

Devices

Devices represent physical telematics or tracking hardware that can be attached to vehicles or other fleet resources.

The Device object

A device stores hardware identity, provider data, attachment state, telemetry status, and latest connectivity information.
Attributes
idstringoptional

Public device identifier.

namestringoptional

Device name.

typestringoptional

Device type.

device_idstringoptional

Provider or hardware device identifier.

serial_numberstringoptional

Device serial number.

telematicstringoptional

Telematic public ID, when loaded.

attachablestringoptional

Attached resource public ID, when loaded.

statusstringoptional

Device status.

connection_statusstringoptional

Derived connection status.

metaobjectoptional

Additional device metadata.

The Device object
{
  "id": "device_7YqM3KpL2n",
  "name": "OBD Tracker 12",
  "type": "obd",
  "device_id": "OBD-12",
  "serial_number": "SN-10001",
  "status": "active",
  "connection_status": "online",
  "attached_to_name": "ABC123",
  "updated_at": "2026-05-07T08:30:00.000000Z",
  "created_at": "2026-05-07T08:30:00.000000Z"
}
POST/v1/devices

Create a Device

Create a device.

Body parameters
namestringoptional

Device name.

typestringoptional

Device type.

device_idstringoptional

Provider or hardware device identifier.

telematicstringoptional

Telematic public ID.

attachable_typestringoptional

Attachable resource type, usually fleet-ops:vehicle.

attachablestringoptional

Attachable resource public ID.

latitudenumberoptional

Last known latitude. Required with longitude.

longitudenumberoptional

Last known longitude. Required with latitude.

metaobjectoptional

Additional metadata.

POST/v1/devices
curl -X POST https://api.fleetbase.io/v1/devices \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "OBD Tracker 12",
  "type": "obd",
  "device_id": "OBD-12",
  "serial_number": "SN-10001",
  "status": "active"
}'
201 OK
{
  "id": "<string>",
  "object": "devices"
}
GET/v1/devices

Query Devices

Query devices.

Query parameters
querystringoptional

Search query for devices.

limitintegeroptional

Maximum number of records to return.

pageintegeroptional

Page number for paginated results.

sortstringoptional

Sort expression, such as -created_at.

statusstringoptional

Filter by status.

attachment_statestringoptional

Filter by attached or unattached.

vehiclestringoptional

Filter by attached vehicle public ID.

connection_statusstringoptional

Filter by connection status.

GET/v1/devices
curl https://api.fleetbase.io/v1/devices \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "devices"
}
GET/v1/devices

Retrieve a Device

Retrieve a device.

GET/v1/devices
curl https://api.fleetbase.io/v1/devices \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "devices"
}
PUT/v1/devices

Update a Device

Update a device.

Body parameters
namestringoptional

Device name.

typestringoptional

Device type.

device_idstringoptional

Provider or hardware device identifier.

telematicstringoptional

Telematic public ID.

attachable_typestringoptional

Attachable resource type, usually fleet-ops:vehicle.

attachablestringoptional

Attachable resource public ID.

latitudenumberoptional

Last known latitude. Required with longitude.

longitudenumberoptional

Last known longitude. Required with latitude.

metaobjectoptional

Additional metadata.

PUT/v1/devices
curl -X PUT https://api.fleetbase.io/v1/devices \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "maintenance"
}'
200 OK
{
  "id": "<string>",
  "object": "devices"
}
DELETE/v1/devices

Delete a Device

Delete a device.

DELETE/v1/devices
curl -X DELETE https://api.fleetbase.io/v1/devices \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "deleted": true
}
POST/v1/devices/attach

Attach Device

Attach this device to a vehicle.

Body parameters
vehiclestringoptional

Vehicle public ID.

POST/v1/devices/attach
curl -X POST https://api.fleetbase.io/v1/devices/attach \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicle": "{{vehicle_id}}"
}'
200 OK
{
  "id": "<string>",
  "object": "devices"
}
POST/v1/devices/detach

Detach Device

Detach this device from its current resource.

POST/v1/devices/detach
curl -X POST https://api.fleetbase.io/v1/devices/detach \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "devices"
}
Devices | Fleetbase