Skip to main content
GET
/
customer
/
{customerId}
/
utilisation
/
driver
Driver Utilisation Hours
curl --request GET \
  --url https://api.masternautconnect.com/connect-webservices/services/public/v1/customer/{customerId}/utilisation/driver \
  --header 'Authorization: Bearer <token>'
{
  "utilisations": [
    {
      "driverId": "<string>",
      "driverName": "<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>"
}

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:ss.

​
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.

​
driverId
string

Identifier (alphanumeric) of a driver.
Must be specified if a value for groupId has not been specified.

​
groupId
string

Identifier (alphanumeric) of a group.

Response

Driver utilisation data successfully returned

Driver utilisation result containing utilisation data for drivers

​
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).