Vehicle Utilisation Hours
Returns summary utilisation information for a vehicle for all journeys where the journey started in the period.
The end date of the journey does not have to be within the period. If the vehicle 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 vehicleId or groupId is not specified, then details for all vehicles are returned. If groupId is specified, then the utilisation for all vehicles in the specified group are included in the output. Either vehicleId 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 format (yyyy-MM-dd'T'HH:mm:ss)
End date and time for the utilisation period in UTC format (yyyy-MM-dd'T'HH:mm:ss)
Unique identifier of the vehicle to retrieve utilisation data for. Must not be used together with groupId
"vehicle-id"
Unique identifier of the group to retrieve utilisation data for all vehicles in the group. Must not be used together with vehicleId
"group-id"
Response
Vehicle utilisation data successfully returned
Response containing vehicle utilisation hours data including individual utilisation records and calculated average start/end times
List of individual vehicle utilisation records with detailed hours and activity data
Calculated average start time across all vehicle utilisations in HH:mm format
Calculated average end time across all vehicle utilisations in HH:mm format
