Latest Trailer Locations

curl --request GET \
  --url https://api.withterminal.com/tsp/v1/trailers/locations \
  --header 'Authorization: Bearer <token>' \
  --header 'Connection-Token: <connection-token>'

{
  "results": [
    {
      "provider": "geotab",
      "trailer": "trl_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,
      "raw": []
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}

GET

trailers

locations

Latest Trailer Locations

curl --request GET \
  --url https://api.withterminal.com/tsp/v1/trailers/locations \
  --header 'Authorization: Bearer <token>' \
  --header 'Connection-Token: <connection-token>'

{
  "results": [
    {
      "provider": "geotab",
      "trailer": "trl_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,
      "raw": []
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}

Authorizations

Authorization

string

header

required

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.

Example:

"con_tkn_22vUhkC6tgre4kwaYfUkCDA1rzn6eyb4"

Query Parameters

limit

integer

The maximum number of results to return in a page.

cursor

string<cursor>

Pagination cursor to start requests from

Example:

"cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"

expand

enum<string>

Expand resources in the returned response

Available options:

trailer

raw

boolean

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

Response

results

Latest Trailer Location · object[]

required

Show child attributes

results.provider

string

required

Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under provider details.

Example:

"geotab"

results.trailer

required

Entities in Terminal are expandable. Using the expand query parameter you can choose to ingest just an ID or the full entity details.

Example:

"trl_01D8ZQFGHVJ858NBF2Q7DV9MNC"

results.locatedAt

string<date-time>

required

ISO 8601 date

Example:

"2021-01-06T03:24:53.000Z"

results.location

Coordinates · object

required

Show child attributes

results.location.longitude

number

required

Example:

-122.4194155

results.location.latitude

number

required

Example:

37.7749295

results.address

object

Reverse geocoded address details for locations when available at the source.

Show child attributes

results.address.formatted

string

Example:

"1.5 miles from Austin, TX"

results.heading

number

Heading in degrees

Example:

25

results.speed

number

Speed in KPH rounded to 2 decimal places.

Example:

95.33

results.raw

RawData · object[]

Show child attributes

results.raw.provider

string

required

results.raw.schema

string

required

results.raw.extractedAt

string

required

results.raw.data

object

required

Example:

[]

string<cursor>

Cursor used for pagination.

Example:

"cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"

List Trailers Get IFTA Summary

⌘I

API Reference

Authentication

Vehicles

Drivers

Hours of Service

Vehicle Utilization

Trips

Devices

Safety

Groups

Trailers

IFTA

Connections

Data Management

Providers

Issues

Fault Codes

Webhook Events

Latest Trailer Locations

Authorizations

Headers

Query Parameters

Response