Driver Utilisation Hours
Returns summary utilisation information for a driver for all journeys where the journey started in the specified period.
The end date of the journey does not have to be within the period. If the vehicle driven by the driver has been configured for a PTO, then driving and idling time with PTO active and with PTO inactive are included in the response. Details for private journeys that started in the period are included in the utilisation values.
If driverId or groupId is not specified, then details for all drivers are returned. If groupId is specified, then the utilisation for all drivers in the specified group are included in the output. Either driverId or groupId can be specified as an input parameter, an error is returned if both are specified.
Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Path Parameters
Query Parameters
Start date and time for the utilisation period in UTC (ISO 8601 format)
End date and time for the utilisation period in UTC (ISO 8601 format)
Unique identifier of the driver to retrieve utilisation data for. Mutually exclusive with groupId.
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
List of individual driver utilisation records with detailed hours and activity data
Calculated average start time across all driver utilisations in HH:mm format
"14:55:22"
Calculated average end time across all driver utilisations in HH:mm format
"15:17:06"
