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 UUID optional — Filter to one driver. 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
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
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.