API reference · Decoding

VIN Decode

Year, make, model, trim, engine, body style and more from a 17-character VIN.

GET https://api.autoparse.io/v1/vin/decode/{vin}

1 credit per successful request. Failed lookups are not charged.

Decodes a VIN into structured specifications: manufacturer, model year, trim, engine, transmission, drivetrain, body style, plant and safety equipment.

New to this endpoint? Read the VIN Decoder API overview.

Overview

The VIN Decode endpoint reads a 17 character Vehicle Identification Number and returns the vehicle specifications encoded in it: manufacturer, model year, trim, engine, transmission, drivetrain, body style, assembly plant and safety equipment. Every field is normalized and structured, so you can store it, search it and display it without parsing free text.

Common use cases

Prefill year, make, model and trim the moment a seller or customer enters a VIN
Validate and normalize VINs before they enter your database
Power search and filtering by body style, drivetrain, fuel type or plant

Response fields

Field	Description
`vin`	The submitted VIN, echoed back in normalized uppercase form.
`year, make, model, trim`	Core identification of the vehicle as built, including the trim level.
`engine`	Engine model, manufacturer, fuel type, cylinders and displacement in liters and cubic inches.
`transmission`	Transmission style and type, for example automatic or manual.
`drivetrain`	Driven wheels, such as FWD, RWD, AWD or 4WD.
`exterior`	Body style, door count and gross vehicle weight rating.
`plant`	Factory where the vehicle was assembled, city and country.
`safety`	Seat belts, tire pressure monitoring and airbag coverage by row.

Parameters

Name	In	Type	Description
`vin`required	path	string	17-character Vehicle Identification Number. ^[A-HJ-NPR-Z0-9]{17}$ e.g. `2G1FK1EJ6A9133857`

Request

cURL

curl "https://api.autoparse.io/v1/vin/decode/2G1FK1EJ6A9133857" \
  -H "x-api-key: $AUTOPARSE_API_KEY"

Response

200 OK

{
  "vin": "2G1FK1EJ6A9133857",
  "body": "Coupe",
  "make": "Chevrolet",
  "trim": "2SS",
  "year": 2010,
  "model": "Camaro",
  "plant": "Oshawa, Ontario, Canada",
  "engine": {
    "fuel": "Gasoline",
    "model": "L99",
    "cylinders": 8,
    "injection": "Sequential Fuel Injection (SFI)",
    "other_info": "Alum",
    "manufacturer": "GM",
    "displacement_l": 6.2,
    "displacement_cc": "6,200 cc",
    "displacement_ci": "378.35 ci"
  },
  "safety": {
    "tpms": "Direct",
    "air_bags": {
      "side": "1st Row (Driver And Passenger)",
      "front": "1st Row (Driver And Passenger)",
      "curtain": "All Rows"
    },
    "seat_belts": "Manual"
  },
  "exterior": {
    "gvwr": "Class 1: 6,000 Lb Or Less (2,722 Kg Or Less)",
    "doors": 2
  },
  "manufacturer": "General Motors LLC",
  "transmission": {
    "style": "Automatic"
  },
  "vehicle_type": "Passenger Car"
}

Errors

Common responses: 400 invalid parameter, 401 bad key, 402 insufficient credits, 404 no data, 429 rate limited. See Errors for the full list.