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`	UUIDoptional	—	Filter to one vehicle. Omit for all.
`limit`	integeroptional	default `100`	Records per page
`page`	integeroptional	default `1`	Page number

Responses

200OK— 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)

401Unauthorized— 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.

Sample request

curl -X GET "https://api.huntereld.com/v2/latest-vehicle-status?limit=100&page=1" \
  -H "X-API-Provider-Key: YOUR_PROVIDER_KEY" \
  -H "X-API-Company-Key: YOUR_COMPANY_KEY"

Example response200 OK

{
  "description": "success",
  "data": [
    {
      "vehicle_id": "e5c9f3b1-2d7a-4e8c-a6f3-9b1d4e7c2f5a",
      "number": "1042",
      "odometer": "248371",
      "fuel_level": 54.8,
      "speed": 62,
      "lat": "41.878113",
      "lon": "-87.629799",
      "status": "IN_MOTION",
      "timestamp": "2026-08-24T14:22:17Z"
    }
  ],
  "total_elements": 31,
  "page": 1,
  "size": 100,
  "total_pages": 1
}

Error response401

{
  "status_code": 401,
  "description": "Company API key is not valid",
  "data": null
}