Vehicle Location History

Returns historical GPS breadcrumb data. Data is available for up to the last 6 months. Query any date range within that window; results paginate via token (up to 1,000 records per page).

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.

Path parameters

Parameter	Type		Description
`vehicle_id`	UUID	required	The vehicle's unique identifier

Query parameters

Parameter	Type		Default	Description
`start_date`	string	required	—	Format MM-DD-YYYY
`end_date`	string	required	—	Format MM-DD-YYYY
`limit`	integer	optional	`100`	Records per page
`next_page_token`	string	optional	—	From the previous response

Response fields

Field	Type	Description
`id`	UUID	Unique record identifier
`vehicle_number`	string	Vehicle or unit number
`lat / lng`	string	Latitude / Longitude
`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.

Sample request

curl -X GET "https://api.lucideld.com/v2/vehicle-location-history/e5c9f3b1-2d7a-4e8c-a6f3-9b1d4e7c2f5a?start_date=03-30-2026&end_date=04-01-2026&limit=100" \
  -H "X-API-Provider-Key: YOUR_PROVIDER_KEY" \
  -H "X-API-Company-Key: YOUR_COMPANY_KEY"

Example response 200 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-04-01T22:14:33Z",
      "calc_location": "I-80 W near Omaha, NE",
      "direction": "270"
    }
  ],
  "size": 100,
  "next_page_token": "AE8AAAACAAAAA19oawAAABFQ/7Vn..."
}