Skip to main content
GET
/
customer
/
{customerId}
/
ecoscore
/
driver
Driver Score
curl --request GET \
  --url https://api.masternautconnect.com/connect-webservices/services/public/v1/customer/{customerId}/ecoscore/driver \
  --header 'Authorization: Bearer <token>'
{
  "totalPages": 123,
  "totalCount": 123,
  "items": [
    {
      "numberOfEngineOverRevvingEvents": 123,
      "numberOfSpeedingEvents": 123,
      "numberOfHarshAccelerationEvents": 123,
      "numberOfHarshBrakingEvents": 123,
      "numberOfHarshCorneringEvents": 123,
      "numberOfExcessiveIdlingOutsideBaseEvents": 123,
      "numberOfExcessiveIdlingInsideBaseEvents": 123,
      "scoreForNumberOfEngineOverRevvingEvents": 123,
      "scoreForNumberOfSpeedingEvents": 123,
      "scoreForNumberOfHarshAccelerationEvents": 123,
      "scoreForNumberOfHarshBrakingEvents": 123,
      "scoreForNumberOfHarshCorneringEvents": 123,
      "scoreForNumberOfExcessiveIdlingOutsideBaseEvents": 123,
      "scoreForNumberOfExcessiveIdlingInsideBaseEvents": 123,
      "scorePerHour": 123,
      "durationSeconds": 123,
      "groupName": "<string>",
      "groupId": "<string>",
      "groupRank": 123,
      "entityInGroup": 123,
      "driverName": "<string>",
      "driverId": "<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>

The start date and time for the period, in UTC, in the format of YYYY-MM-DDThh:mm:ss.

​
endDate
string<date-time>

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

​
driverId
string

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

​
groupId
string

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

​
pageIndex
integer

Specifies the pagination page index.
Pages are zero indexed, i.e.
the first page has an index value of zero.
If not specified, then will default to a pageIndex of 0.

​
pageSize
integer

Specifies the number of items to include on a page.
Must be specified if pageIndex has been specified.
If not specified, then will default to a pageSize of 20.

Response

Successful operation

EcoScore driver response with pagination and driver scoring data

​
totalPages
integer

Total number of pages based on the pageSize.

​
totalCount
integer

Total number of drivers that matched the search parameters.

​
items
object[]

Array of drivers.