Vehicles

Latest Vehicle Locations

Changed on Nov 3, 2026

List the latest location of the vehicles in the connected account. 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.

get/vehicles/locations

Request

Base URL
https://api.withterminal.com/tsp/v1
URL
https://api.withterminal.com/tsp/v1/vehicles/locations
Auth
HTTP bearer

Query parameters

cursorstring cursor

Example:cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw

Pagination cursor to start requests from

limitinteger

The maximum number of results to return in a page.

rawboolean

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

vehicleIdsstring

Comma separated list of vehicle IDs to filter for. Can filter up to 50 vehicles at a time. Each ID must use the vcl_ prefix.

driverIdsstring

Comma separated list of driver IDs to filter for. Can filter up to 50 drivers at a time. Each ID must use the drv_ prefix.

expand'vehicle' | 'driver' | 'vehicle,driver' | 'driver,vehicle'

Expand resources in the returned response

Headers

X-Application-Idstring

Scopes the request to a Terminal application in the caller's organization. Required for multi-application organizations when using a user session or OAuth access token. API keys are already bound to a single application.

Connection-Tokenstring required

Example:con_tkn_22vUhkC6tgre4kwaYfUkCDA1rzn6eyb4

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

Response

nextstring cursor

Cursor used for pagination.

Example response

{
  "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.25,
      "fuel": {
        "primaryPercentage": 50,
        "secondaryPercentage": 50
      },
      "raw": []
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}

Changes

Nov 3, 202671081936e1bd Revision changes
- breaking
  added the pattern ^[A-Za-z0-9+/=_-]+$ to the query request parameter cursor
- warning
  added the new oauth_client_id_unknown enum value to the response property for the response status
- warning
  added the new provider_timeout enum value to the response property for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added subschema #2 to the / response property allOf list for the response status
- info
  removed subschema #1: Base Vehicle Location subschema #2 from the / response property allOf list for the response status
- info
  the response's property pattern ^[A-Za-z0-9+/=_-]+$ was added for the status

Operation history