OPEN API
  1. Hours Of Service
OPEN API
  • Organization Info
    • Get information about your organization
      GET
  • Drivers
    • List all drivers
      GET
    • Retrieve a driver
      GET
  • Hours Of Service
    • Get HOS clocks
      GET
    • Get all driver HOS daily logs
      GET
    • Get HOS logs
      GET
  • Vehicles
    • List all vehicles
      GET
    • Retrieve a vehicle
      GET
  • Vehicle Locations
    • Historical Vehicle Locations
      GET
    • Latest Vehicle Locations
      GET
  • Trips
    • Get Vehicle Trips
      GET
  • Vehicle Stats
    • Vehicle Stats snapshot
      GET
  • Maintenance
    • Get all DVIRs
      GET
  • IFTA
    • Get IFTA jurisdiction reports
      GET
  • Webhook
    • Sample Webhook request for specific trigger
      GET
    • Subscribe to specific immediately events
      POST
    • Available list of Triggers
      GET
    • Unsubscribe form events
      POST
  1. Hours Of Service

Get HOS logs

GET
http://127.0.0.1:8001/openapi/hos/logs/
Hours Of Service
Returns HOS logs between a given startedAfter and startedBefore. The logs can be further filtered using tags or by providing a list of driver IDs.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
page
integer 
optional
A page number within the paginated result set.
page_size
integer 
optional
Number of results to return per page.
driverIds
array[string]
required
startedAfter
string <date-time>
optional
2024-05-22T01:40:16.274753Z
startedBefore
string <date-time>
optional
2024-05-22T01:40:16.274753Z

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1:8001/openapi/hos/logs/?driverIds'

Responses

🟢200OK
application/json
Body
count
integer 
optional
Example:
10
page_size
integer 
optional
Example:
123
previous
integer  | null 
optional
Example:
null
current
integer 
optional
Example:
1
next
integer  | null 
optional
Example:
2
results
array[object (HosLogsResponse) {9}] 
optional
id
string 
required
driver
string  | null 
required
Driver ID
vehicle
string  | null 
required
Vehicle ID
codrivers
array[string]
read-onlyrequired
Co Driver ID
startedAt
string <date-time>
optional
endedAt
string <date-time>
optional
location
object (Location) 
required
status
enum<string> 
required
offDuty - offDuty
sleepingBed - sleepingBed
driving - driving
onDuty - onDuty
intermediateW/CLP - intermediateW/CLP
intermediateW/RLP - intermediateW/RLP
personalConveyance - personalConveyance
yardMove - yardMove
certification - certification
login - login
logout - logout
enginePowerUpW/CLP - enginePowerUpW/CLP
enginePowerUpW/RLP - enginePowerUpW/RLP
engineShutDownW/CLP - engineShutDownW/CLP
engineShutDownW/RLP - engineShutDownW/RLP
malfunctionLogged - malfunctionLogged
malfunctionCleared - malfunctionCleared
diagnosticEventLogged - diagnosticEventLogged
diagnosticEventCleared - diagnosticEventCleared
Allowed values:
offDutysleepingBeddrivingonDutyintermediateW/CLPintermediateW/RLPpersonalConveyanceyardMovecertificationloginlogoutenginePowerUpW/CLPenginePowerUpW/RLPengineShutDownW/CLPengineShutDownW/RLPmalfunctionLoggedmalfunctionCleareddiagnosticEventLoggeddiagnosticEventCleared
remark
string 
required
Remark
Example
{
  "count": 10,
  "page_size": 123,
  "previous": null,
  "current": 1,
  "next": 2,
  "results": [
    {
      "id": "string",
      "driver": "string",
      "vehicle": "string",
      "codrivers": [
        "string"
      ],
      "startedAt": "2019-08-24T14:15:22Z",
      "endedAt": "2019-08-24T14:15:22Z",
      "location": {
        "latitude": 0,
        "longitude": 0
      },
      "status": "offDuty",
      "remark": "string"
    }
  ]
}
Previous
Get all driver HOS daily logs
Next
List all vehicles
Built with