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://api.firsteld.com/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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://api.firsteld.com/openapi/hos/logs/?driverIds'
Response Response 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"
        }
    ]
}

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

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
Modified at 2025-04-23 00:31:51
Previous
Get all driver HOS daily logs
Next
List all vehicles
Built with