GET/v2/latest-driver-status

Latest Driver Status

Returns current Hours of Service and duty status for one or all drivers.

HOS values are in milliseconds

Divide by 3,600,000 for hours. Drivers with no HOS activity appear with null values.

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
`driver_id`	UUIDoptional	—	Filter to one driver. 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
`driver_id`	UUID	Unique driver identifier
`username`	string	Driver's login username
`break`	integer	Remaining break time (ms)
`drive`	integer	Remaining drive time (ms)
`shift`	integer	Remaining shift time (ms)
`cycle`	integer	Remaining cycle time (ms)
`current_status`	string	Current duty status code One of:`DS_DDS_ONDS_SBDS_OFFDR_IND_PCDR_IND_YM`

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-driver-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": [
    {
      "driver_id": "d4f7b2e9-1a3c-4d8f-b5e6-2c9a7d3f1e0b",
      "username": "jcarter01",
      "break": 27000000,
      "drive": 32400000,
      "shift": 41400000,
      "cycle": 198000000,
      "current_status": "DS_D"
    }
  ],
  "total_elements": 48,
  "page": 1,
  "size": 100,
  "total_pages": 1
}

Error response401

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