ELD INTEGRATION CONTRACT

List duty-status events

Read structured duty-status transitions for an authorized daily record.

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

GET/v1/duty-status-events

REQUIRED SCOPEeld:logs:read

Behavior & boundaries

A transition establishes the status beginning at recorded_at. The following event or period boundary determines its end.

Free-text annotations, location, actor identity, and driver lookup fields are excluded.

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

Request parameters

log_idstring · required

Required opaque daily-record reference.

fromdate-time · required

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

todate-time · required

Exclusive UTC end. Must follow from.

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 duty-event reference.
`log_id`string	Daily-record reference.
`recorded_at`date-time	UTC time the transition took effect.
`duty_status`string	Resulting duty state. `off_dutysleeper_berthdrivingon_duty`
`operating_category`string	Special operating category, without location data. `normalpersonal_conveyanceyard_move`
`source`string	Provenance category; not an actor identifier. `enginemanualaccepted_edit`
`revision`integer	Version of this event.

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/duty-status-events?limit=25&log_id=log_example_7f2a&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/duty-status-events?limit=25&log_id=log_example_7f2a&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_duty_1", "log_id": "log_example_7f2a", "recorded_at": "2026-10-15T07:00:00Z", "duty_status": "driving", "operating_category": "normal", "source": "engine", "revision": 1 } ], "next_cursor": null }