GET /v2/latest-vehicle-status

Latest Vehicle Status

Returns the most recent location and motion status for one or all vehicles.

Data freshness
ELDs report ~every 60s in motion, less often when stationary. Polling more than every 30s returns the same data and counts against your rate limit.
Pagination
Start at page=1 and keep requesting while page is less than total_pages. Every response reports page, size, total_elements, and total_pages in the response envelope.

Authentication

Send both headers on every request. How auth works →
  • X-API-Provider-Key Your provider key Identifies your platform. The same for every request.
  • X-API-Company-Key The carrier's company key Scopes all returned data to that one carrier.

Query parameters

Parameter Type Default Description
vehicle_id UUID optional — Filter to one vehicle. Omit for all.
limit integer optional default 100 Records per page
page integer optional default 1 Page number

Responses

200 OK Success — payload in data, wrapped in the response envelope.
Field Type Description
vehicle_id UUID Unique vehicle identifier
number string Vehicle or unit number
odometer string Odometer reading (miles)
fuel_level New number Fuel level as a percentage from 0 to 100. Returns 0 when the vehicle does not report fuel data.
speed integer Current speed (mph)
lat string Latitude
lon string Longitude
status string Current motion status
One of: IN_MOTIONSTATIONARYOFFLINE
timestamp string Time of reading (UTC, ISO-8601)
401 Unauthorized Missing or invalid API key.
Field Type Description
status_code integer HTTP status code (e.g. 401).
description string Human-readable error message.
data null Always null on error.