Telematics API
Fleet data. One API.
Choose the data you need. Every authorized connection uses these endpoints, response shapes and units.
Preview reference. Endpoint availability depends on your environment's release and authorized connection. Extended telemetry requires explicit opt-in and provider validation. Check your release before integrating.
Read a vehicle profile →Get stored vehicle identity and metadata with a normalized vehicle ID.Read completed trips →Get stored trips, distance, duration and current vehicle references.Get location or current meters →Read location, lifetime odometer and engine runtime through one endpoint.Update a meter on demand →Request current readings when an app action needs an update.Trigger a service case →Read new and cleared faults with a durable cursor.See which assets run or sit →Compare engine runtime with observed time, with explicit coverage.Read earlier observations →Retrieve stored readings for a metric and time window.Connect a customer's fleet →Prepare provider credentials and record approval before separate activation.
Endpoint reference
Each endpoint includes path/query parameters, a request example, response fields, a synthetic response example and error behavior.
| Endpoint | Use it for |
|---|---|
POST /v1/syncs | Manage durable sync work through one API with application and connection authorization. |
GET /v1/syncs | Manage durable sync work through one API with application and connection authorization. |
GET /v1/syncs/{id} | Manage durable sync work through one API with application and connection authorization. |
POST /v1/syncs/{id}/retry | Manage durable sync work through one API with application and connection authorization. |
POST /v1/syncs/{id}/cancel | Manage durable sync work through one API with application and connection authorization. |
GET /v1/connections/{id}/trips | Read stored completed trips through one API with normalized vehicle/driver references. |
GET /v1/connections/{id}/trips/{tripId} | Read one current authorized trip by its stable trp_ ID. |
GET /v1/connections/{id}/drivers | Read the last complete driver directory without contacting a provider. |
GET /v1/connections/{id}/groups | Read stored group directories or approved groups and their parent relationships using one API. |
GET /v1/connections/{id}/groups/{groupId} | Read one group from the authorized stored account directory. |
GET /v1/connections/{id}/drivers/{driverId} | Read one driver using its stable normalized driver ID. |
GET /v1/connections/{id}/vehicles/{vehicleId}/metadata | Read provider-supplied vehicle identity, status and group references through the unified API. |
GET /v1/connections/{id}/vehicles/{vehicleId}/profile | Read cached vehicle enrichment through the unified API, with independent availability for each product. |
GET /v1/connections/{id}/vehicles/{vehicleId}/identity | Read cached vehicle enrichment through the unified API, with independent availability for each product. |
GET /v1/connections/{id}/vehicles/{vehicleId}/images | Read cached vehicle enrichment through the unified API, with independent availability for each product. |
GET /v1/connections/{id}/vehicles/{vehicleId}/specifications | Read cached vehicle enrichment through the unified API, with independent availability for each product. |
GET /v1/connections/{id}/vehicles/{vehicleId}/build | Read cached vehicle enrichment through the unified API, with independent availability for each product. |
GET /v1/connections/{id}/locations | Read the latest stored location for every asset in an authorized connection. |
GET /v1/catalog | Discover normalized fields, units, API operations and request limits. |
GET /v1/connections/{id} | Read the authorized fleet connection's identity and collection health. |
GET /v1/connections/{id}/capabilities | Discover which normalized fields the connection can provide. |
POST /v1/connections/{id}/connect-sessions | Start customer authorization through a short-lived hosted connection link. |
GET /v1/connections/{id}/connect-sessions/{sessionId} | Check whether a customer's connection flow completed. |
POST /v1/connections/{id}/disconnect | Disable this connection's local access and collection. |
GET /v1/connections/{id}/vehicles | List core assets or normalized account-bound vehicle profiles. |
GET /v1/connections/{id}/vehicles/{vehicleId} | Read an independently authorized stored vehicle by normalized vcl ID with scope=directory. |
GET /v1/connections/{id}/vehicles/{vehicleId}/telemetry | Get the latest location, odometer, engine runtime and other normalized readings for an asset. |
POST /v1/connections/{id}/vehicles/{vehicleId}/refresh | Request current asset readings, then return the same normalized telemetry shape. |
GET /v1/connections/{id}/faults | Read current open fault occurrences across the connection. |
GET /v1/connections/{id}/fault-events | Read opened and cleared transitions for service-case triggers and incremental syncing. |
GET /v1/connections/{id}/vehicles/{vehicleId}/history | Read stored normalized observations for an asset and time window. |
GET /v1/connections/{id}/vehicles/{vehicleId}/utilization | Measure how much an asset's engine ran versus did not run during observed time. |
GET /v1/connections/{id}/vehicles/{vehicleId}/distance | Measure distance accumulated during valid observed odometer intervals. |
GET /v1/connections/{id}/vehicles/{vehicleId}/engine-hours | Measure engine runtime accumulated during valid observed intervals. |
GET /v1/connections/{id}/vehicles/{vehicleId}/idling | Measure idle duration from supported cumulative idle counters. |
GET /v1/connections/{id}/utilization | Read per-asset observed usage summaries for the authorized fleet. |
All examples use synthetic assets and timestamps. Data catalog · Catalog JSON · OpenAPI