Get Vehicle Trips

GET

http://api.firsteld.com/openapi/trips/

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 Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://api.firsteld.com/openapi/trips/'

Response 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
                        }
                    }
                }
            ]
        }
    ]
}

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

Modified at 2025-04-23 00:31:51

Latest Vehicle Locations

Vehicle Stats snapshot