ELD INTEGRATION CONTRACT

List connection events

Review changes in the local vehicle-to-mobile-device connection.

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

GET/v1/vehicle-connections

REQUIRED SCOPEeld:vehicles:read

Behavior & boundaries

Bluetooth availability and internet synchronization are separate states. This resource concerns the vehicle connection.

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 connection-event reference.
`vehicle_id`string	Equipment reference.
`device_id`string	Interface reference.
`recorded_at`date-time	UTC observation time.
`state`string	Connection state after this event. `connecteddisconnectedunknown`
`reason_code`string	Structured cause without free-text details. `link_establishedlink_lostpower_offunknown`

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/vehicle-connections?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/vehicle-connections?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_connection_1", "vehicle_id": "veh_example_014", "device_id": "eld_example_014", "recorded_at": "2026-10-15T06:00:00Z", "state": "connected", "reason_code": "link_established" } ], "next_cursor": null }