API Documentation: Vehicle VIN numbers

GET /api/vin-numbers/:usdot

This endpoint retrieves a list of VIN (Vehicle Identification Numbers) associated with a specified USDOT number.

URL

https://api.onroadnetworks.com/api/vin-numbers/:usdot

Parameters:

  • :usdot (required): The USDOT number for which VIN numbers are being requested.

Authentication

To access this endpoint, the following headers must be included in the request:

Key:x-api-key
Value:API key value
Key:provider-token
Value:Provider token value

Example

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

Response format

JSON
[
    "1HGCM82633A004352",
    "1FAFP4041WF287392",
    ...
]

Generating API Key

API keys can be generated by following the steps below:

  1. In the left sidebar, navigate to the “API Keys” section under “More”
  2. Click the “Add a key” button in the top right
  3. Fill in the key name and configure access settings, then submit the form
Step №1
First step
Step №2
Second step
Step №3
Third step
Step №4
Fourth step

Test Data

Endpoint:https://api.onroadnetworks.com/api/units/:usdot
USDOT:0
x-api-key:2b2y38VUi9AWSSUQRn5GD8eKLuKFlORBV7rk-8dCmFTAonRoadELD
provider-token:1R8xFqCfchWVnjjQonRoadELD
cURL
curl --location --request GET 'https://api.onroadnetworks.com/api/vin-numbers/0' --header 'x-api-key: 2b2y38VUi9AWSSUQRn5GD8eKLuKFlORBV7rk-8dCmFTAonRoadELD' --header 'provider-token: 1R8xFqCfchWVnjjQonRoadELD'

Notes

  • Ensure that the API key and provider token are kept secure and not exposed in client-side code.
  • The response includes only VIN numbers; no additional vehicle details are provided in this endpoint.
  • This endpoint is useful for quick checks or initial data fetching before deeper vehicle-specific queries.