Get telematics HOS data

Retrieve HOS Logs

SecuritybearerAuth

Request

query Parameters

userId	string or null Can use user ID. Example: userId=5100FFFF-60B6-D7CD-3FA2-22CA712B0000
limit	integer or null Number of records to return. Example: limit=5000
offset	integer or null Record to start with. Example: offset=1500
startDate	string <date-time> The start date must be within the last 60 days. Example: startDate=2023-06-01
endDate	string <date-time> End date to filter by. Example: endDate=2023-06-02
order	string or null Sort direction. Example: order=asc
sortProperty	string or null Name of property to sort on. Example: sortProperty=name
version required	string or null API version number. Example: version=1

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

get/plus/v1/hos

Request samples

curl
JavaScript
Node.js

Response samples

application/json

{"data": [{"id": "hos1f6e56d-1234-4567-89ab-cdef12345678",
"annotations": [{"comment": "Driver noted a delay due to traffic.",
"dateTime": "2025-05-29T19:20:26.063Z",
"driver": { },
"id": "ann1f6e56d-1234-4567-89ab-cdef12345678",
"version": "v1.0"
}
],
"coDrivers": [{"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"firstName": "John",
"lastName": "Doe",
"name": "John Doe",
"licenseNumber": "DL-123456",
"licenseProvince": "CA",
"acceptedEULA": 1,
"driveGuideVersion": 2,
"wifiEULA": 1,
"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"lastAccessDate": "2025-09-15T12:22:30.000Z",
"companyName": "Acme Corp",
"companyAddress": "123 Main Street, Toronto, ON",
"carrierNumber": "CARR123",
"isDriver": true,
"isEmailReportEnabled": false,
"language": "en-US",
"timeZoneId": "America/Toronto",
"userAuthenticationType": 1,
"zoneDisplayMode": 2,
"driverGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [null
],
"color": { }
}
],
"companyGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [null
],
"color": { }
}
],
"keys": [{ }
],
"bookmarks": [{ }
],
"viewDriversOwnDataOnly": false,
"designation": "Manager",
"employeeNo": "EMP12345",
"phoneNumber": "+1-123-456-7890",
"phoneNumberExtension": "101"
}
],
"dateTime": "2025-05-29T19:18:26.063Z",
"deferralMinutes": 15,
"deferralStatus": "Active",
"device": {"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"comment": "Installed in vehicle A123",
"groups": ["Group1",
"Group2"
],
"timeZoneId": "America/Toronto",
"deviceFlags": "FLAG_001",
"deviceType": "GO9",
"hardwareId": "HW-ABC-12345",
"ignoreDownloadsUntil": "2025-05-15T12:00:00.000Z",
"maxSecondsBetweenLogs": 300,
"name": "Device A123",
"productId": "PROD-456",
"serialNumber": "SN123456789",
"timeToDownload": "2025-09-20T10:00:00.000Z",
"workTime": "08:00-17:00",
"registerDeviceResultLite": { },
"devicePlanBillingInfo": { },
"deviceReplacementInfo": { },
"customProperties": { },
"mediaFiles": ["file1.jpg",
"file2.mp4"
],
"tmpTrailerId": "TRAILER-123",
"version": "v1.2.3"
},
"driver": {"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"firstName": "John",
"lastName": "Doe",
"name": "John Doe",
"licenseNumber": "DL-123456",
"licenseProvince": "CA",
"acceptedEULA": 1,
"driveGuideVersion": 2,
"wifiEULA": 1,
"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"lastAccessDate": "2025-09-15T12:22:30.000Z",
"companyName": "Acme Corp",
"companyAddress": "123 Main Street, Toronto, ON",
"carrierNumber": "CARR123",
"isDriver": true,
"isEmailReportEnabled": false,
"language": "en-US",
"timeZoneId": "America/Toronto",
"userAuthenticationType": 1,
"zoneDisplayMode": 2,
"driverGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"companyGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"keys": [{ }
],
"bookmarks": [{ }
],
"viewDriversOwnDataOnly": false,
"designation": "Manager",
"employeeNo": "EMP12345",
"phoneNumber": "+1-123-456-7890",
"phoneNumberExtension": "101"
},
"editDateTime": "2025-05-29T20:18:26.063Z",
"editRequestedByUser": {"id": "1b33bcbe-15d3-445e-a06f-dda61208ad18",
"firstName": "John",
"lastName": "Doe",
"name": "John Doe",
"licenseNumber": "DL-123456",
"licenseProvince": "CA",
"acceptedEULA": 1,
"driveGuideVersion": 2,
"wifiEULA": 1,
"activeFrom": "2023-10-06T00:22:30.000Z",
"activeTo": "2025-10-06T00:22:30.000Z",
"lastAccessDate": "2025-09-15T12:22:30.000Z",
"companyName": "Acme Corp",
"companyAddress": "123 Main Street, Toronto, ON",
"carrierNumber": "CARR123",
"isDriver": true,
"isEmailReportEnabled": false,
"language": "en-US",
"timeZoneId": "America/Toronto",
"userAuthenticationType": 1,
"zoneDisplayMode": 2,
"driverGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"companyGroups": [{"id": "grp-123",
"name": "Drivers Group",
"comment": "Main driver group",
"reference": "REF123",
"parent": { },
"children": [{ }
],
"color": { }
}
],
"keys": [{ }
],
"bookmarks": [{ }
],
"viewDriversOwnDataOnly": false,
"designation": "Manager",
"employeeNo": "EMP12345",
"phoneNumber": "+1-123-456-7890",
"phoneNumberExtension": "101"
},
"engineHours": 5.5,
"eventCode": 101,
"eventRecordStatus": 1,
"eventType": 2,
"isIgnored": false,
"isTransitioning": false,
"location": { },
"malfunction": "None",
"odometer": 12550,
"origin": "Truck",
"parentId": "parent123",
"sequence": "1",
"state": "ON_DUTY",
"status": "Active",
"verifyDateTime": "2025-05-29T21:18:26.063Z",
"version": "v1.0"
}
]
}