Skip to content
//VIN Decoder example\\

Decode a fleet list with recalls, ratings and MPG

Specs, recall campaigns, owner complaints, NCAP stars and EPA fuel economy for a mixed list of US-market vehicles.

Updated November 13, 2026

What this example returns

The dataset’s “Decoded VINs” view shows 19 columns: VIN, Year, Make, Model, Trim, Body, Cylinders, Litres, HP, Fuel, Drive, Transmission, Plant country, Maker country, Recalls, Complaints, NCAP stars, MPG combined, and Check digit OK. See every output field.

What each setting does

The input this example runs VIN Decoder with. “Try this input” opens it in the console, where you can run it as-is or change any field first.

VINs vins

1HGCM82633A004352, 5yj3e1ea2kf317000, 1FTFW1ET9-DFC10312, JTDKB20U493500000 2009, 1G1ZD5STXJF123456, 1GCUYDED2LZ123456, 5FNRL6H78LB123456, KNDJP3A50H7123456, 1HGCM82633A004352, not-a-vin

17-character Vehicle Identification Numbers, one per line. Lower case, spaces and dashes are fine. Add a model year after a VIN ("1HGCM82633A004352 2003") when you know it; it helps with VINs whose year code is ambiguous. Duplicates are decoded once. There is no limit on how many VINs one run decodes.

Recalls includeRecalls

Yes

Every NHTSA safety recall campaign for the vehicle's model year, make and model: campaign number, date, component, summary, consequence and remedy.

Owner complaints includeComplaints

Yes

NHTSA owner complaint totals for the model: count, crashes, fires, injuries, deaths, the most named components and the first and last filing date.

NCAP crash ratings includeSafetyRatings

Yes

NHTSA 5-Star Safety Ratings (overall, frontal, side, side pole, rollover and rollover risk) for the closest matching body and drive variant.

EPA fuel economy includeFuelEconomy

Yes

EPA city, highway and combined MPG, annual fuel cost, CO2 per mile, EPA scores and, for electric cars, range and kWh per 100 miles, matched on engine, transmission and drive.

All raw decode fields includeRawFields

No

Also add every non-empty field of the NHTSA vPIC decode (up to about 140) under nhtsa_raw.

.json
{
  "vins": [
    "1HGCM82633A004352",
    "5yj3e1ea2kf317000",
    "1FTFW1ET9-DFC10312",
    "JTDKB20U493500000 2009",
    "1G1ZD5STXJF123456",
    "1GCUYDED2LZ123456",
    "5FNRL6H78LB123456",
    "KNDJP3A50H7123456",
    "1HGCM82633A004352",
    "not-a-vin"
  ],
  "includeRecalls": true,
  "includeComplaints": true,
  "includeSafetyRatings": true,
  "includeFuelEconomy": true,
  "includeRawFields": false
}

What it costs

You pay for the events the actor reports, such as each result or page it produces. Platform usage is included in the event prices: compute, proxies, browser and storage cost nothing extra.

  • Decoded VIN$0.00125One VIN decoded and saved with its specs and, when switched on, its recalls, complaints, crash ratings and fuel economy.

Full pricing

When to use this example

From the VIN Decoder readme:

Known limit

EPA fuel economy covers model year 1984 and later. When several EPA variants fit equally well, the first closest one is returned with match = closest.

Other ways to run VIN Decoder

All examples of VIN Decoder

About VIN Decoder

Decode VINs in bulk: year, make, model, trim, engine, transmission, drive, body and plant for every 17-character VIN, plus NHTSA recalls, owner complaints, NCAP crash ratings and EPA fuel economy. No login or API key needed.

Price:
$1.25 / 1,000 results
Developer:
Roam & Roof

VIN Decoder pageOutput fieldsPricing

Related actors

//From the blog\\

Latest articles

All articles

The internet is full of data.
Start owning yours.

Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes.

No credit card. No setup calls.