HOS Logs API

Access Hours of Service (HOS) logs and duty status records.

Get Driver Logs

Retrieve ELD logs for a specific driver.

GET /api/hos/driver/{driver_id}

Path Parameters

Parameter	Type	Description
driver_id	string (UUID)	The driver's unique identifier

Query Parameters

Parameter	Type	Required	Description
start_time	string	No	Start date (YYYY-MM-DD)
end_time	string	No	End date (YYYY-MM-DD)

Response

{
  "driver_id": "550e8400-e29b-41d4-a716-446655440000",
  "logs": [
    {
      "id": "log-uuid",
      "event_type": "1",
      "event_code": "3",
      "duty_status": "DR",
      "start_time": "2025-11-20T08:00:00Z",
      "end_time": "2025-11-20T11:30:00Z",
      "duration_minutes": 210,
      "location": {
        "lat": 34.0522,
        "long": -118.2437,
        "address": "Los Angeles, CA"
      },
      "odometer": 125430,
      "engine_hours": 4521.5,
      "note": ""
    }
  ]
}

GET/api/hos/driver/{driver_id}

API Key

Path Parameters

driver_id

Query Parameters

start_time

end_time

---

Get Log Details

Retrieve detailed information for a specific ELD log entry.

GET /api/hos/{log_id}

GET/api/hos/{log_id}

API Key

Path Parameters

log_id

---

Get Daily Logs

Retrieve daily log summaries.

GET /api/hos/daily

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number
limit	integer	No	Items per page
driver_id	string	No	Filter by driver
date	string	No	Filter by date (YYYY-MM-DD)

GET/api/hos/daily

API Key

Query Parameters

page

limit

---

Get Driver Certify Status

Check if a driver has certified their logs for a specific date.

GET /api/hos/certify/{driver_id}/{date}

Path Parameters

Parameter	Type	Description
driver_id	string (UUID)	The driver's unique identifier
date	string	Date in YYYY-MM-DD format

GET/api/hos/certify/{driver_id}/{date}

API Key

Path Parameters

driver_id

date