GET/v2/vehicle-location-history/{vehicle_id}

Vehicle Location History

Returns a vehicle's historical GPS breadcrumbs for up to the last 6 months.

Token-based pagination

Tokens are tied to the original vehicle_id, start_date, and end_date. Changing any of those requires a new query. You cannot page backwards.

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.

Path parameters

Parameter	Type	Description
`vehicle_id`	UUIDrequired	The vehicle's unique identifier

Query parameters

Parameter	Type	Default	Description
`start_date`	stringrequired	—	Format MM-DD-YYYY
`end_date`	stringrequired	—	Format MM-DD-YYYY
`limit`	integeroptional	default `100`	Records per page
`next_page_token`	stringoptional	—	From the previous response

Responses

200OK— payload in data, wrapped in the response envelope.

Field	Type	Description
`id`	UUID	Unique record identifier
`vehicle_number`	string	Vehicle or unit number
`vin`	string	Vehicle Identification Number
`lat`	string	Latitude
`lng`	string	Longitude
`status`	string	Motion status at the reading One of:`IN_MOTIONSTATIONARYOFFLINE`
`speed`	string	Speed at the reading (mph)
`timestamp`	string	Time of reading (UTC, ISO-8601)
`calc_location`	string	Human-readable location
`direction`	string	Heading in degrees (0–360)
`next_page_token`	string	Pass back in your next request. Absent on last page.

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/vehicle-location-history/e5c9f3b1-2d7a-4e8c-a6f3-9b1d4e7c2f5a?start_date=08-20-2026&end_date=08-22-2026&limit=100" \
  -H "X-API-Provider-Key: YOUR_PROVIDER_KEY" \
  -H "X-API-Company-Key: YOUR_COMPANY_KEY"

Example response200 OK

{
  "description": "success",
  "data": [
    {
      "id": "c3f1a7d9-5e2b-4c8f-a1d4-7b9e3f6a2c0d",
      "vehicle_number": "1042",
      "vin": "1XKYD49X3NJ312847",
      "lat": "41.253789",
      "lng": "-95.934162",
      "status": "IN_MOTION",
      "speed": "58",
      "timestamp": "2026-08-22T22:14:33Z",
      "calc_location": "I-80 W near Omaha, NE",
      "direction": "270"
    }
  ],
  "size": 100,
  "next_page_token": "AE8AAAACAAAAA19oawAAABFQ/7Vn..."
}

Error response401

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