ELD INTEGRATION CONTRACT

List ELD devices

Read the interface metadata associated with ELD-equipped vehicles.

Contract referenceData endpoints are not available on this website. Examples are illustrative. No live requests are sent from this portal.

GET/v1/eld-devices

REQUIRED SCOPEeld:devices:read

Behavior & boundaries

Device records do not establish hardware compatibility or certification. Example firmware is fabricated.

Results are ordered by device_id.

Returns only resources authorized to the credential's carrier and integration. Driver profiles, contact details, and identity expansion are excluded.

Request parameters

vehicle_idstring · optional

Optional equipment reference; only resources authorized to this integration.

limitinteger · optional

Records per page. Default 25; minimum 1, maximum 100.

cursorstring · optional

Opaque next_cursor from the previous response. Keep the same filters. Null ends the traversal.

Unsupported parameters, including driver selectors and identity expansion, are outside this contract. Read the field policy →

Response fields 200

data is an array of the objects below. next_cursor is a string or null. Every listed field is present; nullable values explicitly indicate unavailable information.

Field / type	Description
`device_id`string	Opaque ELD interface reference.
`vehicle_id`string \| null	Associated equipment reference; null if unassigned.
`firmware_version`string \| null	Reported firmware version; null if unavailable.
`connection_state`string	Observed connection state. `connecteddisconnectedunknown`
`last_seen_at`date-time \| null	Time of the latest accepted device observation.

Error responses

400 invalid parameters · 401 invalid credential · 403 insufficient scope · 404 absent or inaccessible resource · 429 rate limit · 503 unavailable.

Error envelope and retry guidance →

KEEP BUILDING WITH CONTEXTReview the data boundaries →

using var client = new HttpClient { BaseAddress = new Uri(Environment.GetEnvironmentVariable("API_BASE_URL")!) }; client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue( "Bearer", Environment.GetEnvironmentVariable("ACCESS_TOKEN")); using var response = await client.GetAsync("/v1/eld-devices?limit=25"); response.EnsureSuccessStatusCode(); var json = await response.Content.ReadAsStringAsync();

{ "data": [ { "device_id": "eld_example_014", "vehicle_id": "veh_example_014", "firmware_version": "example-1.0", "connection_state": "connected", "last_seen_at": "2026-10-15T16:00:00Z" } ], "next_cursor": null }