Skip to main content
GET
Driver Utilisation Hours

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

customerId
string
required

Query Parameters

startDate
string<date-time>
required

Start date and time for the utilisation period in UTC (ISO 8601 format)

endDate
string<date-time>
required

End date and time for the utilisation period in UTC (ISO 8601 format)

driverId
string

Unique identifier of the driver to retrieve utilisation data for. Mutually exclusive with groupId.

groupId
string

Unique identifier of the group to retrieve utilisation data for all drivers in the group. Mutually exclusive with driverId.

Response

Driver utilisation data successfully returned

Response containing driver utilisation hours data including individual utilisation records and calculated average start/end times

utilisations
object[]

List of individual driver utilisation records with detailed hours and activity data

averageStartTime
string

Calculated average start time across all driver utilisations in HH:mm format

Example:

"14:55:22"

averageEndTime
string

Calculated average end time across all driver utilisations in HH:mm format

Example:

"15:17:06"