Tracking API v3

Provides real-time vehicle tracking data including location, unit number, VIN, and timestamp for all units associated with a USDOT number.

Endpoint

GEThttps://read.tteld.com/api/externalservice/units-by-usdot/:usdot

Authentication Headers

Header	Value
`x-api-key`	Your API key
`provider-token`	Your provider token

Path Parameters

Parameter	Required	Description
`usdot`	Yes	Company USDOT number

Example Request

bash

curl --location \
  'https://read.tteld.com/api/externalservice/units-by-usdot/123456' \
  --header 'x-api-key: <your_key>' \
  --header 'provider-token: <your_token>'

Response Format

Returns a units array containing the current tracking data for all vehicles under the specified USDOT.

json

{
  "units": [
    {
      "truck_number": "554322",
      "vin": "4V4NC9EJ0PN613787",
      "id": 293,
      "coordinates": {
        "lat": 27.6830997467041,
        "lng": -99.4631118774414
      },
      "rotation": 217,
      "timestamp": "2026-04-10T02:08:48.316Z",
      "odometer": 493932,
      "speed": 9
    }
  ]
}

Response Fields

Field	Type	Description
`truck_number`	string	Assigned truck number
`vin`	string	Vehicle Identification Number
`id`	number	Internal unit identifier
`coordinates.lat`	number	Current latitude
`coordinates.lng`	number	Current longitude
`rotation`	number	Vehicle heading in degrees (0–360)
`timestamp`	string	ISO 8601 timestamp of the last tracking update
`odometer`	number	Odometer reading in miles
`speed`	number	Current speed in mph

API Key Generation

Keys are created via the company's main dashboard account. Navigate to the sidebar, scroll to "More", then select API Keys. See the full guide: How to Create an API Key.

Tracking by VIN Number API (v3)

Tracking API (v3)