Tracking by VIN Number API v2

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

Endpoint

GEThttps://read.rulereld.com/api/v2/unit-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 --request GET \
  'https://read.rulereld.com/api/v2/unit-by-vin/0/4V4NC9EG0FN911517' \
  --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": "string",
    "vin": "string",
    "coordinates": {
      "lat": 0.0,
      "lng": 0.0
    },
    "timestamp": "2026-01-10T08:32:11.000Z"
  }
}

Response Fields

Field	Type	Description
`truck_number`	string	Assigned truck number
`vin`	string	Vehicle Identification Number
`coordinates.lat`	number	Current latitude
`coordinates.lng`	number	Current longitude
`timestamp`	string	ISO 8601 timestamp of the last tracking update

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 (v2) — by USDOT

Tracking by VIN Number API (v2)