v1

latestOpenAPI 3.1.02026-07-2617501.1 MB

List the drivers with Hours of Service (HOS) violations

get/v1/hos_violations

Query parameters

driver_ids[]integer[]

Specify 1 or more driver IDs for whom you want to check the HOS violations.

min_start_timestring date

Specify a start time from when you want to check the driver HOS violations.

max_start_timestring date

Specify the end time till when you want to check the HOS violations.

violation_typesstring

Specify a violation type to filter the API response accordingly.

per_pageinteger

Number of records per page.

page_nointeger

Denotes the page number.

Headers

X-Time-Zonestring

Specify the timezone for formatting the timestamps.

X-Metric-Unitsboolean

Specify if you want to use the Metric units or the Imperial units. TRUE: Metric units. FALSE: Imperial Units

X-User-Idinteger

Specify the ID of the Fleet Admin or the Fleet Manager who is accessing this endpoint.

Response

200

Example response

{
  "hos_violations": [
    {
      "hos_violation": {
        "id": 97,
        "type": "ca_duty_15",
        "start_time": "2016-03-12T19:00:00Z",
        "name": "15 Hour On Duty Limit",
        "user": {
          "id": 156,
          "first_name": "Harold",
          "last_name": "Hoeger",
          "username": "hobart",
          "status": "deactivated",
          "role": "driver"
        }
      }
    }
  ],
  "pagination": {
    "per_page": 25,
    "page_no": 1,
    "total": 1
  }
}