Get Vehicle Trips

Get historical trips data for filtered vehicles. This method returns a set of historical trips data for vehicles in the specified time range.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

page

integer

optional

A page number within the paginated result set.

page_size

integer

optional

Number of results to return per page.

vehicleIds

array[string]

optional

startedAfter

string <date-time>

optional

2024-05-22T01:40:16.274753Z

startedBefore

string <date-time>

optional

2024-05-22T01:40:16.274753Z

Responses

🟢200OK

application/json

Body

count

integer

optional

Example:

page_size

integer

optional

Example:

123

integer | null

optional

Example:

null

current

integer

optional

Example:

integer | null

optional

Example:

results

array[object (TripResponse) {2}]

optional

vehicle_id

string <uuid>

required

Vehicle ID

items

array[object (VehicleRoute) {14}]

required

Example

{
  "count": 10,
  "page_size": 123,
  "previous": null,
  "current": 1,
  "next": 2,
  "results": [
    {
      "vehicle_id": "e57c411b-caf2-4a2e-b2e8-e232824b6ddf",
      "items": [
        {
          "id": "",
          "driver_id": "",
          "driver_first_name": "",
          "driver_last_name": "",
          "start_event_datetime": "2019-08-24T14:15:22Z",
          "start_total_odometer": 0,
          "end_event_datetime": "2019-08-24T14:15:22Z",
          "end_total_odometer": 0,
          "duration": 0,
          "distance": 0,
          "snapshot": "http://example.com",
          "start": {
            "name": "",
            "date": "2019-08-24T14:15:22Z",
            "location": {
              "id": "",
              "name": "",
              "speed": 0,
              "latitude": 0,
              "longitude": 0,
              "heading": 0,
              "state": "",
              "direction": "",
              "date": "2019-08-24T14:15:22Z",
              "total_odometer": 0,
              "odometer_type": "miles",
              "motion_type": "",
              "distance": 0
            }
          },
          "locations": [
            {
              "id": "",
              "name": "",
              "speed": 0,
              "latitude": 0,
              "longitude": 0,
              "heading": 0,
              "state": "",
              "direction": "",
              "date": "2019-08-24T14:15:22Z",
              "total_odometer": 0,
              "odometer_type": "miles",
              "motion_type": "",
              "distance": 0
            }
          ],
          "end": {
            "name": "",
            "date": "2019-08-24T14:15:22Z",
            "location": {
              "id": "",
              "name": "",
              "speed": 0,
              "latitude": 0,
              "longitude": 0,
              "heading": 0,
              "state": "",
              "direction": "",
              "date": "2019-08-24T14:15:22Z",
              "total_odometer": 0,
              "odometer_type": "miles",
              "motion_type": "",
              "distance": 0
            }
          }
        }
      ]
    }
  ]
}

Get Vehicle Trips

Request

Request samples

Responses