Skip to main content
GET
/
customer
/
{customerId}
/
ecoscore
/
event
/
vehicle
Vehicle Score Events
curl --request GET \
  --url https://api.masternautconnect.com/connect-webservices/services/public/v1/customer/{customerId}/ecoscore/event/vehicle \
  --header 'Authorization: Bearer <token>'
{
  "totalPages": 123,
  "totalCount": 123,
  "items": [
    {
      "vehicleRegistration": "<string>",
      "vehicleName": "<string>",
      "vehicleId": "<string>",
      "driverName": "<string>",
      "driverId": "<string>",
      "vehicleGroupName": "<string>",
      "vehicleGroupId": "<string>",
      "driverGroupName": "<string>",
      "driverGroupId": "<string>",
      "eventType": "<string>",
      "eventDate": "2023-11-07T05:31:56Z",
      "eventDurationMs": 123,
      "speedKph": 123,
      "rateOfAcceleration": 123,
      "rateOfLateralAcceleration": 123,
      "rateOfDeceleration": 123,
      "locationId": "<string>",
      "locationName": "<string>",
      "locationCategoryId": "<string>",
      "locationCategoryName": "<string>",
      "idlingFidelity": 123
    }
  ]
}

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.

vehicleId
string

Identifier for a vehicle.
Must be specified if a value for groupId has not been specified.

groupId
string

Identifier of a group.
Must be specified if a value for vehicleId 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

Paginated response for EcoScore driving events

totalPages
integer

Total number of pages based on the pageSize.

totalCount
integer

Total number of events that matched the search parameters.

items
object[]

Array of driving events.