← Docs

VIN Decoder API

Decode a VIN. Year, make, model, engine, and plant out.

Decode a 17-character VIN. You get the build: year, make, model, trim, body, doors, engine, drive, transmission, the manufacturer, and the plant that assembled it. Spaces and case do not matter. Junk or a failed ISO 3779 check digit answers valid: false as a 200, never a 404. The data comes from the manufacturer's own filings with official sources. Fields the filing leaves blank are null. Foreign-market VINs decode partially.

?deep=true adds deep.recalls on paid plans: open recall campaigns for the decoded year, make, and model. Each row carries the campaign number, report date, component, and the summary verbatim. [] when none are open. Decode and recalls are the whole product. Market value, ownership history, and title checks are not.

Decode

GET
api.parseapi.com/vin/{vin}
Year, make, model, engine, and plant from a 17-character VIN
curl "https://api.parseapi.com/vin/1HGCM82633A004352" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "vin": "1HGCM82633A004352",
  "valid": true,
  "year": 2003,
  "make": "Honda",
  "model": "Accord",
  "trim": "EX-V6",
  "series": null,
  "body": "coupe",
  "type": "passenger car",
  "doors": 2,
  "cylinders": 6,
  "displacement": 3,
  "fuel": "gasoline",
  "horsepower": 240,
  "drive": null,
  "transmission": "automatic",
  "manufacturer": "American Honda Motor Co., Inc.",
  "plant_city": "Marysville",
  "plant_state": "Ohio",
  "plant_country": "United States",
  "gvwr": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)"
}
curl "https://api.parseapi.com/vin/1hgcm826%2033a-004352" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "vin": "1HGCM82633A004352",
  "valid": true,
  "year": 2003,
  "make": "Honda",
  "model": "Accord",
  "trim": "EX-V6",
  "series": null,
  "body": "coupe",
  "type": "passenger car",
  "doors": 2,
  "cylinders": 6,
  "displacement": 3,
  "fuel": "gasoline",
  "horsepower": 240,
  "drive": null,
  "transmission": "automatic",
  "manufacturer": "American Honda Motor Co., Inc.",
  "plant_city": "Marysville",
  "plant_state": "Ohio",
  "plant_country": "United States",
  "gvwr": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)"
}
curl "https://api.parseapi.com/vin/1HGCM82613A004352" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "vin": "1HGCM82613A004352",
  "valid": false,
  "year": null,
  "make": null,
  "model": null,
  "trim": null,
  "series": null,
  "body": null,
  "type": null,
  "doors": null,
  "cylinders": null,
  "displacement": null,
  "fuel": null,
  "horsepower": null,
  "drive": null,
  "transmission": null,
  "manufacturer": null,
  "plant_city": null,
  "plant_state": null,
  "plant_country": null,
  "gvwr": null
}
curl "https://api.parseapi.com/vin/1HGCM82633A004352?deep=true" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "vin": "1HGCM82633A004352",
  "valid": true,
  "year": 2003,
  "make": "Honda",
  "model": "Accord",
  "trim": "EX-V6",
  "series": null,
  "body": "coupe",
  "type": "passenger car",
  "doors": 2,
  "cylinders": 6,
  "displacement": 3,
  "fuel": "gasoline",
  "horsepower": 240,
  "drive": null,
  "transmission": "automatic",
  "manufacturer": "American Honda Motor Co., Inc.",
  "plant_city": "Marysville",
  "plant_state": "Ohio",
  "plant_country": "United States",
  "gvwr": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
  "deep": {
    "recalls": [
      {
        "campaign": "19V499000",
        "date": "2019-06-27",
        "component": "AIR BAGS:FRONTAL:DRIVER SIDE:INFLATOR MODULE",
        "summary": "Honda (American Honda Motor Co.) is recalling certain 2003 Acura 3.2CL, 2002-2003 3.2TL, 2003-2006 MDX, 2001-2007 Honda Accord..."
      }
    ]
  }
}

Response fields

vin
Normalized VIN, uppercase, no spaces. Invalid input still echoes the fold
valid
17 characters and the ISO 3779 check digit both pass
year
Model year
make
Make (Honda, BMW)
model
Model name as the manufacturer filed it
trim
Trim level, or null
series
Series, or null
body
Body style (sedan, coupe, suv, pickup)
type
Vehicle type (passenger car, truck, motorcycle, bus, trailer)
doors
Door count, or null
cylinders
Engine cylinders, or null
displacement
Engine displacement in liters, or null
fuel
Primary fuel (gasoline, diesel, electric)
horsepower
Engine horsepower when published, or null
drive
Drive type (fwd, rwd, awd, 4wd), or null
transmission
Transmission style (automatic, manual, cvt), or null
manufacturer
Manufacturer of record
plant_city
Assembly plant city, or null
plant_state
Assembly plant state or region, or null
plant_country
Assembly plant country, or null
gvwr
Gross vehicle weight rating class as filed, or null
deep.recalls
Open recall campaigns for the decoded year, make, and model. campaign, date, component, summary verbatim. [] when none, null when the registry did not answer. Paid plans

Questions? Email