Skip to main content
GET
/
customer
/
{customerId}
/
utilisation
/
vehicle
Vehicle Utilisation Hours
curl --request GET \
  --url https://api.masternautconnect.com/connect-webservices/services/public/v1/customer/{customerId}/utilisation/vehicle \
  --header 'Authorization: Bearer <token>'
{
  "utilisations": [
    {
      "assetId": "<string>",
      "assetRegistration": "<string>",
      "assetName": "<string>",
      "groupName": "<string>",
      "utilisation": [
        {
          "firstStart": "2023-11-07T05:31:56Z",
          "lastStop": "2023-11-07T05:31:56Z",
          "totalTime": 123,
          "driveTime": 123,
          "driveTimeWithPto": 123,
          "driveTimeWithoutPto": 123,
          "idleTime": 123,
          "idleTimeWithPto": 123,
          "stopTime": 123,
          "countOfStopTime": 123
        }
      ],
      "averageStartTime": "<string>",
      "averageEndTime": "<string>"
    }
  ],
  "averageStartTime": "<string>",
  "averageEndTime": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerId
string
required

Query Parameters

startDate
string<date-time>
required

The start date and time for the period, in UTC, in the format of YYYY-MM-DDThh:mm:ssstartDate=2014-03-20T00:00:00

endDate
string<date-time>
required

The end date and time for the period, in UTC, in the format of YYYY-MM-DDThh:mm:ss.
The end date cannot be before the startDate.

vehicleId
string

Identifier of a vehicle (alphanumeric)

groupId
string

Identifier of a group (alphanumeric)

Response

Vehicle utilisation data successfully returned

Vehicle utilisation result containing utilisation data for vehicles

utilisations
object[]

Array of utilisation details

averageStartTime
string

Average start time, hh:mm:ss (in UTC)

averageEndTime
string

Average end time, hh:mm:ss (in UTC).