How each product works

How to use VIN Decoder

What VIN Decoder takes in, which fields it returns and how credits are charged for each lookup.

Last updated 2026-10-22

What it does

Decodes a 17-character vehicle identification number with the US NHTSA vPIC service: model year, make, model, trim, body, engine, drivetrain, assembly plant and the safety equipment NHTSA has on record. The check digit is verified before NHTSA is called. Empty fields mean NHTSA has no data, not that the feature is missing.

What you send

Send these fields in the JSON body of the request.

Request fields for VIN Decoder
FieldTypeRequiredLimits
vinstringRequiredup to 40 characters
ignore_check_digitbooleanOptionalno extra limit
model_yearintegerOptionalat least 1,981, at most 2,040

Request fields for VIN Decoder

What you get back

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Each field is described in the API reference.

Response fields for VIN Decoder
FieldType
vinstring
model_yearnumber
makestring
modelstring
trimstring
seriesstring
vehicle_typestring
body_classstring
doorsnumber
drive_typestring
transmissionstring
fuel_type_primarystring
fuel_type_secondarystring
electrification_levelstring
engineobject
plantobject
manufacturerstring
gvwrstring
safetyobject
decode_quality"complete" or "partial"
warningslist
additional_notesstring
suggested_vinstring
notesstring

Response fields for VIN Decoder

What it costs

1 credit per VIN that decodes (a VIN with no data is free).

What each outcome costs
CaseCharge
Found1 credit
Nothing found0 credits
Repeat inside 7 days0 credits
Errors and invalid requests0 credits

What each outcome costs

Run it

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/vin-decoder with your API key.

curl -X POST https://YOUR_API_HOST/v1/vin-decoder \
  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin":"1HGCM82633A004352"}'

A request to VIN Decoder

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

Good to know

  • A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
  • When the lookup finds nothing it returns found: false and costs 0 credits.
  • Invalid input and errors are never charged.
  • The API allows 200 requests per 10 seconds per key.

Still stuck? Write to hello@lookvalid.com.