Tracking by VIN Number API v3

This endpoint delivers real-time vehicle tracking data by VIN number, including location, unit number, and related details.

Endpoint

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

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 (use `0` if unknown)
`vin`	Yes	Vehicle Identification Number (17 characters)

Example Request

bash

curl --location \
  'https://read.tteld.com/api/externalservice/tracking-by-vin/12345/4V4NC9EJ0PN613787' \
  --header 'x-api-key: <your-api-key>' \
  --header 'provider-token: <your-provider-token>'

Response Format

Returns a unit object with the current real-time tracking data for the specified vehicle.

json

{
  "unit": {
    "truck_number": "554322",
    "vin": "4V4NC9EJ0PN613787",
    "id": 293,
    "coordinates": {
      "lat": 31.979997634887695,
      "lng": -102.03300476074219
    },
    "rotation": 248,
    "timestamp": "2026-04-09T02:42:46.064Z",
    "odometer": 493458,
    "speed": 10
  }
}

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

Notes

:usdot and :vin are URL path parameters
A legacy endpoint path (/api/unit-by-vin/) also exists in some documentation examples

API Key Generation

Keys are created via the company's main dashboard account. Navigate to the sidebar → "More" section → API Keys page. See the full guide: How to Create an API Key.

Tracking API (v3) — by USDOT

Tracking by VIN Number API (v3)