Vehicles tracking

Retrieves live tracking details for all vehicles registered to a USDOT number — location, unit identifier, VIN, make/model, and more.

The response includes every unit currently active for the given USDOT number; if none are active, the units array is empty. All timestamps are in ISO 8601 format.

Parameters

usdot

string · required · path

The USDOT number associated with the units.

x-api-key

string · required · header

Your API key. Generate one under More → API Keys in the dashboard.

provider-token

string · required · header

Your provider token, issued alongside the API key.

Example request

cURL

curl --location --request GET 'https://api.onroadnetworks.com/api/units/:usdot' \
  --header 'x-api-key: ${key}' \
  --header 'provider-token: ${token}'

Example response

JSON

{
  "units": [
    {
      "truckNumber": "string",
      "vin": "string",
      "coordinates": { "lat": 0.0, "lng": 0.0 },
      "timestamp": "string date",
      "licensePlate": { "state": "string", "number": "string" },
      "assetType": "string",
      "unixTimestamp": 0,
      "deviceId": "string",
      "make": "string",
      "model": "string",
      "year": 0,
      "fuelType": "string"
    }
  ]
}

Vehicle tracking by VIN