ELD INTEGRATION CONTRACT

List ELD diagnostics

Review structured ELD diagnostic and malfunction observations.

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

GET/v1/eld-diagnostics

REQUIRED SCOPEeld:diagnostics:read

Behavior & boundaries

These categories describe ELD data health, not general vehicle fault codes or maintenance alerts.

An empty result does not prove device compliance or successful malfunction monitoring.

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

Request parameters

fromdate-time · required

Inclusive UTC start. Required; range cannot exceed 31 days.

todate-time · required

Exclusive UTC end. Must follow from.

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
`event_id`string	Opaque health-event reference.
`device_id`string	Interface reference.
`vehicle_id`string	Equipment reference.
`recorded_at`date-time	UTC observation time.
`kind`string	Type of ELD health event. `diagnosticmalfunction`
`category`string	Structured data-health category. `powerengine_synchronizationtimingpositioningdata_recordingdata_transferunidentified_records`
`state`string	Whether the condition is active or cleared. `activecleared`

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 →

curl --request GET \ --url "${API_BASE_URL}/v1/eld-diagnostics?limit=25&from=2026-10-15T00%3A00%3A00Z&to=2026-10-16T00%3A00%3A00Z" \ --header "Authorization: Bearer $ACCESS_TOKEN" \ --header "Accept: application/json"

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-diagnostics?limit=25&from=2026-10-15T00%3A00%3A00Z&to=2026-10-16T00%3A00%3A00Z"); response.EnsureSuccessStatusCode(); var json = await response.Content.ReadAsStringAsync();

{ "data": [ { "event_id": "evt_example_diagnostic_1", "device_id": "eld_example_014", "vehicle_id": "veh_example_014", "recorded_at": "2026-10-15T16:05:00Z", "kind": "diagnostic", "category": "engine_synchronization", "state": "active" } ], "next_cursor": null }