GET
/
vehicles
/
locations
curl --request GET \
  --url https://api.withterminal.com/tsp/v1/vehicles/locations \
  --header 'Authorization: Bearer <token>' \
  --header 'Connection-Token: <connection-token>'
{
  "results": [
    {
      "provider": "geotab",
      "vehicle": "vcl_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "driver": "drv_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "locatedAt": "2021-01-06T03:24:53.000Z",
      "location": {
        "longitude": -122.4194155,
        "latitude": 37.7749295
      },
      "address": {
        "formatted": "1.5 miles from Austin, TX"
      },
      "heading": 25,
      "speed": 95.33,
      "odometer": 100,
      "raw": []
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}

This endpoint will call the provider’s API in real time to get the latest location of the vehicle. Please note: this endpoint will exclude vehicles that have no last known location.

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Connection-Token
string
required

The token returned when a user authenticated their account. This authorizes access to a specific account.

Query Parameters

cursor
string

Pagination cursor to start requests from

limit
integer

The maximum number of results to return in a page.

raw
boolean

Include raw responses used to normalize model. Used for debugging or accessing unique properties that are not unified.

vehicleIds
string

Comma separated list of vehicle IDs to filter for

driverIds
string

Comma separated list of driver IDs to filter for

expand
enum<string>

Expand resources in the returned response

Available options:
vehicle,
driver,
vehicle,driver,
driver,vehicle

Response

200 - application/json
results
object[]
required
next
string

Cursor used for pagination.