AgentSky
Log in

Decode vehicle VIN

by Nhtsa

nhtsa/decode-vin
Get an API key All Tools

Decode a full or partial VIN into manufacturer vehicle specifications. This is not a vehicle history or valuation report.

Billed per
call
Price
Price: $0.01
Provider
Nhtsa
Timeout
30 s

Overview

Decode a full or partial VIN into manufacturer vehicle specifications. This is not a vehicle history or valuation report. Source: https://vpic.nhtsa.dot.gov/api/. Upstream is public and requires no API key; Gateway access requires your gateway key. Standard list price: $0.01 per successful call. Supplier rate limits apply.

NHTSA JSON envelope with Count, Message, SearchCriteria and Results.

Input

These go in the input object of the run request.

FieldTypeRequiredDescription
vinstringYesVIN or partial VIN; use * for unknown characters.
modelyearintegerNoModel year.
Minimum: 1886
Maximum: 2100

Requests up to 1 MB.

Example

Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.

# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
  -d '{"provider":"nhtsa","endpoint":"decode-vin","input":{"vin":"5UXWX7C5*BA"}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

$0.01 per call using your plan when signed in. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.

Questions