docs / api / vin / decoder

VIN Decoder API

The VIN Decoder API provides access to a library of vehicle specifications data covering attributes, color options, equipment details, recall information, warranties, and photos; it also allows for a “selections” request that can be used to retrieve lists of vehicles based on their year, make, model, trim, style, or ID. Get started today with an active VinAudit API key. HTTPS calls are made to (specifications.vinaudit.com) see below for the complete documentation details.

GET

https://specifications.vinaudit.com/v3/specifications?

Request Parameters

Parameter

vin

required

Example

2T1BURHE3EC020936

Description

The vehicle identification number

Parameter

key

required

Example

YOUR_API_KEY_HERE

Description

Your VinAudit API key

Parameter

format

optional

Example

VA_DEMO_KEY

Description

Your VinAudit API key

Parameter

include

optional

Example

selections,attributes,equipment,colors,recalls,warranties,photos

Description

Type of data to be included in the response

Parameter	Description	Example
vinrequired	The vehicle identification number	2T1BURHE3EC020936
keyrequired	Your VinAudit API key	YOUR_API_KEY_HERE
formatoptional	Your VinAudit API key	VA_DEMO_KEY
includeoptional	Type of data to be included in the response	selections,attributes,equipment,colors,recalls,warranties,photos

Response Attributes

Field

input

Type

{“key”:”VA_DEMO_KEY”, “vin”:”1NXBR32E85Z505904″, “format”:”json”, “include”:”selections,attributes”}

Description

Contains the input parameters specified by the query

Field

selections

Type

{“trims”:[{“id”:”2013_bmw_3series_328i”, “name”:”328i”, “selected”:1, “styles”:[{“id”:”2013_bmw_3series_328i_sedan, “name”:”Sedan”,”selected”:1}]}]}

Description

Contains the trim IDs, trim names, style IDs, and style names

Field

attributes

Type

{“year”:”2004″, “make”:”Toyota”, “model”:”Corolla”, “trim”:”S”, “style”:””, “type”:”Car”, “size”:”Compact”, “category”:”Compact Cars”, “made_in”:”America”, “made_in_city”:”Cambridge”, “doors”:”4″, “fuel_type”:”Regular Unleaded”, “fuel_capacity”:”13.20 gallons”, “city_mileage”:”30 – 32 miles\/gallon”, “highway_mileage”:”38 – 41 miles\/gallon”, “engine”:”1.8-L L-4 DOHC 16V”, “engine_size”:”1.8-L”, “engine_cylinders”:”L-4″, “transmission”:”4-Speed Automatic 5-Speed Manual”, “transmission_type”:”Manual”, “transmission_speeds”:”5-Speed”}

Description

A map of specifications about the VIN (VIN, Year, Make, Model, Trim, Trim Selections, Style, Type, Size, Category, Made In, Made In City, Doors, Fuel Type, Fuel Capacity, CityMileage, Highway Mileage, Engine, Engine Size, Engine Cylinders, Transmission, Transmission Type, Transmission Speeds, Drivetrain, Anti-Brake System, Steering Type, Curb Weight, Gross Weight, Gross Vehicle Weight Rating, Overall Height, Overall Length, Overall Width, Wheelbase Length, Standard Seating, Invoice Price, Delivery Charges, Manufacturer Suggested Retail Price)

Field

colors

Type

[{“category”:”Exterior”, “name”:”Super White”}, {“category”:”Exterior”, “name”:”Silver Streak Mica”}, {“category”:”Exterior”, “name”:”Impulse RED”}, {“category”:”Exterior”, “name”:”Black Sand Pearl”}, {“category”:”Exterior”, “name”:”Indigo INK Pearl”}, {“category”:”Exterior”, “name”:”Phantom Gray Pearl”}]

Description

Details about available color options based on the vehicle’s year, make, model

Field

equipment

Type

[{“group”:”Anti-Theft & Locks”, “name”:”Child Safety Door Locks”, “availability”:”Standard”}, {“group”:”Anti-Theft & Locks”, “name”:”Power Door Locks”, “availability”:”Standard”}, {“group”:”Anti-Theft & Locks”, “name”:”Vehicle Anti-Theft”, “availability”:”Standard”}, {“group”:”Braking & Traction”, “name”:”ABS Brakes”, “availability”:”Optional”}, {“group”:”Safety”, “name”:”Driver Airbag”, “availability”:”Standard”}, {“group”:”Safety”, “name”:”Front Side Airbag”, “availability”:”Optional”}, {“group”:”Safety”, “name”:”Passenger Airbag”, “availability”:”Standard”}, {“group”:”Safety”, “name”:”Trunk Anti-Trap Device”, “availability”:”Standard”}, {“group”:”Remote Controls & Release”, “name”:”Keyless Entry”, “availability”:”Standard”}, {“group”:”Climate Control”, “name”:”Air Conditioning”, “availability”:”Standard”}, {“group”:”Interior Features”, “name”:”Cruise Control”, “availability”:”Optional”}, {“group”:”Interior Features”, “name”:”Tachometer”, “availability”:”Standard”}, {“group”:”Interior Features”, “name”:”Tilt Steering Column”, “availability”:”Standard”}, {“group”:”Interior Features”, “name”:”Genuine Wood Trim”, “availability”:”Optional”}, {“group”:”Entertainment,Communication & Navigation”, “name”:”AM\/FM Radio”, “availability”:”Standard”}, {“group”:”Entertainment, Communication & Navigation”, “name”:”CD Player”, “availability”:”Standard”}, {“group”:”Entertainment, Communication & Navigation”, “name”:”CD Changer”, “availability”:”Optional”}, {“group”:”Seat”, “name”:”Second Row Folding Seat”, “availability”:”Standard”}, {“group”:”Storage”, “name”:”Cargo Net”, “availability”:”Optional”}, {“group”:”Storage”, “name”:”Load Bearing Exterior Rack”, “availability”:”Optional”}, {“group”:”Roof”, “name”:”Power Sunroof”, “availability”:”Optional”}, {“group”:”Roof”, “name”:”Manual Sunroof”, “availability”:”Optional”}, {“group”:”Exterior Lighting”, “name”:”Daytime Running Lights”, “availability”:”Standard”}, “name”:”Front Air Dam”, “availability”:”Standard”}, {“group”:”Exterior Features”, “name”:”Rear Spoiler”, “availability”:”Optional”}, {“group”:”Exterior Features”, “name”:”Splash Guards”, “availability”:”Optional”}, {“group”:”Tires & Wheels”, “name”:”Alloy Wheels”, “availability”:”Optional”}, {“group”:”Tires & Wheels”, “name”:”Steel Wheels”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Power Windows”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Power Adjustable Exterior Mirror”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Interval Wipers”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Rear Window Defogger”, “availability”:”Standard”}, {“group”:”Chassis”, “name”:”Anti-Brake System”, “value”:”Non-Abs | 4-Wheel ABS”}, {“group”:”Chassis”,”name”:”Steering Type”, “value”:”R&P”}, {“group”:”Chassis”, “name”:”Front Brake Type”, “value”:”Disc”}, {“group”:”Chassis”, “name”:”Rear Brake Type”, “value”:”Drum”}, {“group”:”Chassis”, “name”:”Front Suspension”, “value”:”IND”}, {“group”:”Chassis”, “name”:”Rear Suspension”, “value”:”Semi”}, {“group”:”Chassis”, “name”:”Front Spring Type”,”value”:”Coil”}, {“group”:”Chassis”, “name”:”Rear Spring Type”, “value”:”Coil”}, {“group”:”Chassis”, “name”:”Tires”, “value”:”195\/65r15″}, {“group”:”Interior Dimensions”, “name”:”Front Headroom”, “value”:”39.10 In.”}, {“group”:”Interior Dimensions”, “name”:”Rear Headroom”, “value”:”37.10 In.”}, {“group”:”Interior Dimensions”, “name”:”Front Legroom”, “value”:”41.30 In.”}, {“group”:”Interior Dimensions”, “name”:”Rear Legroom”, “value”:”35.40 In.”}, {“group”:”Interior Dimensions”, “name”:”Front Shoulder Room”, “value”:”53.10 In.”}, {“group”:”Interior Dimensions”, “value”:”53.50 In.”}, {“group”:”Interior Dimensions”, “name”:”Front Hip Room”, “value”:”51.90 In.”}, {“group”:”Interior Dimensions”, “name”:”Rear Hip Room”, “value”:”46.20 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Curb Weight-automatic”, {“group”:”Exterior Dimensions & Weight”, “name”:”Curb Weight-manual”, “value”:”2524 Lbs”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Overall Length”, “value”:”178.30 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Overall Width”, {“group”:”Exterior Dimensions & Weight”, “name”:”Overall Height”, “value”:”58.50 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Wheelbase”, “value”:”102.40 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Ground Clearance”, “value”:”5.70 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Track Front”, “value”:”58.30 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Track Rear”, “value”:”57.50 In.”}, {“group”:”Cargo Bed Dimensions”, “name”:”Overall Length”, {“group”:”Capacities”, “name”:”Standard Seating”, “Value”:”5″}, {“group”:”Capacities”, “name”:”Passenger Volume”, “value”:”90.30 Cu.ft.”}, {“group”:”Capacities”, “name”:”Cargo Volume”, “value”:”13.60 Cu.ft.”}, {“group”:”Capacities”, “name”:”Standard Towing”, “value”:”1500 Lbs”}, {“group”:”Capacities”, “name”:”Maximum Towing”, “value”:”1500 Lbs”}]

Description

Details about a vehicle’s equipment based on the vehicle’s year, make, model

Field

recalls

Type

[{“source”:”NHTSA”, “campaign”:”15V285000″, “date”:”20150513″, “components”:”AIR BAGS”, “summary”:”Toyota Motor Engineering & Manufacturing (Toyota) notified the agency on May 13, 2015 that they are recalling certain model year…”}]

Description

Details about recall information based on the vehicle’s year, make, model, and trim

Field

warranties

Type

[{“type”:”Basic”, “miles”:”36,000 miles”, “months”:”36 months”}, {“type”:”Powertrain”, “miles”:”60,000 miles”, “months”:”60 months”}, {“type”:”Rust”, “months”:”60 months”, “miles”:”Unlimited miles”}]

Description

Details about manufacturer warranties based on the vehicle’s year, make, model, and trim

Field

photos

Type

[{“url”:”https://imgset.info/a/1NXBR38E74Z195377_20190205_0-43001?size=medium”}, {“url”:”https://imgset.info/a/1NXBR32E04Z192720_20190205_0-46560?size=medium”}, {“url”:”https://imgset.info/a/JTDBR32E042024060_20190205_0-44966?size=medium”}]

Description

Photos based on the vehicle’s year, make, model, and trim

Field

success

Type

true

Description

Whether vehicle specifications data exists

Field

error

Type

invalid_vin

Description

One of the following error codes… invalid_inputs (missing VIN, ID, or year/make/model/trim) invalid_vin (not a valid VIN) no_data (no specifications available) api_not_enabled (functionality not enabled for API key) or (blank) if no error

Field	Description	Type
input	Contains the input parameters specified by the query	{“key”:”VA_DEMO_KEY”, “vin”:”1NXBR32E85Z505904″, “format”:”json”, “include”:”selections,attributes”}
selections	Contains the trim IDs, trim names, style IDs, and style names	{“trims”:[{“id”:”2013_bmw_3series_328i”, “name”:”328i”, “selected”:1, “styles”:[{“id”:”2013_bmw_3series_328i_sedan, “name”:”Sedan”,”selected”:1}]}]}
attributes	A map of specifications about the VIN (VIN, Year, Make, Model, Trim, Trim Selections, Style, Type, Size, Category, Made In, Made In City, Doors, Fuel Type, Fuel Capacity, CityMileage, Highway Mileage, Engine, Engine Size, Engine Cylinders, Transmission, Transmission Type, Transmission Speeds, Drivetrain, Anti-Brake System, Steering Type, Curb Weight, Gross Weight, Gross Vehicle Weight Rating, Overall Height, Overall Length, Overall Width, Wheelbase Length, Standard Seating, Invoice Price, Delivery Charges, Manufacturer Suggested Retail Price)	{“year”:”2004″, “make”:”Toyota”, “model”:”Corolla”, “trim”:”S”, “style”:””, “type”:”Car”, “size”:”Compact”, “category”:”Compact Cars”, “made_in”:”America”, “made_in_city”:”Cambridge”, “doors”:”4″, “fuel_type”:”Regular Unleaded”, “fuel_capacity”:”13.20 gallons”, “city_mileage”:”30 – 32 miles\/gallon”, “highway_mileage”:”38 – 41 miles\/gallon”, “engine”:”1.8-L L-4 DOHC 16V”, “engine_size”:”1.8-L”, “engine_cylinders”:”L-4″, “transmission”:”4-Speed Automatic 5-Speed Manual”, “transmission_type”:”Manual”, “transmission_speeds”:”5-Speed”}
colors	Details about available color options based on the vehicle’s year, make, model	[{“category”:”Exterior”, “name”:”Super White”}, {“category”:”Exterior”, “name”:”Silver Streak Mica”}, {“category”:”Exterior”, “name”:”Impulse RED”}, {“category”:”Exterior”, “name”:”Black Sand Pearl”}, {“category”:”Exterior”, “name”:”Indigo INK Pearl”}, {“category”:”Exterior”, “name”:”Phantom Gray Pearl”}]
equipment	Details about a vehicle’s equipment based on the vehicle’s year, make, model	[{“group”:”Anti-Theft & Locks”, “name”:”Child Safety Door Locks”, “availability”:”Standard”}, {“group”:”Anti-Theft & Locks”, “name”:”Power Door Locks”, “availability”:”Standard”}, {“group”:”Anti-Theft & Locks”, “name”:”Vehicle Anti-Theft”, “availability”:”Standard”}, {“group”:”Braking & Traction”, “name”:”ABS Brakes”, “availability”:”Optional”}, {“group”:”Safety”, “name”:”Driver Airbag”, “availability”:”Standard”}, {“group”:”Safety”, “name”:”Front Side Airbag”, “availability”:”Optional”}, {“group”:”Safety”, “name”:”Passenger Airbag”, “availability”:”Standard”}, {“group”:”Safety”, “name”:”Trunk Anti-Trap Device”, “availability”:”Standard”}, {“group”:”Remote Controls & Release”, “name”:”Keyless Entry”, “availability”:”Standard”}, {“group”:”Climate Control”, “name”:”Air Conditioning”, “availability”:”Standard”}, {“group”:”Interior Features”, “name”:”Cruise Control”, “availability”:”Optional”}, {“group”:”Interior Features”, “name”:”Tachometer”, “availability”:”Standard”}, {“group”:”Interior Features”, “name”:”Tilt Steering Column”, “availability”:”Standard”}, {“group”:”Interior Features”, “name”:”Genuine Wood Trim”, “availability”:”Optional”}, {“group”:”Entertainment,Communication & Navigation”, “name”:”AM\/FM Radio”, “availability”:”Standard”}, {“group”:”Entertainment, Communication & Navigation”, “name”:”CD Player”, “availability”:”Standard”}, {“group”:”Entertainment, Communication & Navigation”, “name”:”CD Changer”, “availability”:”Optional”}, {“group”:”Seat”, “name”:”Second Row Folding Seat”, “availability”:”Standard”}, {“group”:”Storage”, “name”:”Cargo Net”, “availability”:”Optional”}, {“group”:”Storage”, “name”:”Load Bearing Exterior Rack”, “availability”:”Optional”}, {“group”:”Roof”, “name”:”Power Sunroof”, “availability”:”Optional”}, {“group”:”Roof”, “name”:”Manual Sunroof”, “availability”:”Optional”}, {“group”:”Exterior Lighting”, “name”:”Daytime Running Lights”, “availability”:”Standard”}, “name”:”Front Air Dam”, “availability”:”Standard”}, {“group”:”Exterior Features”, “name”:”Rear Spoiler”, “availability”:”Optional”}, {“group”:”Exterior Features”, “name”:”Splash Guards”, “availability”:”Optional”}, {“group”:”Tires & Wheels”, “name”:”Alloy Wheels”, “availability”:”Optional”}, {“group”:”Tires & Wheels”, “name”:”Steel Wheels”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Power Windows”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Power Adjustable Exterior Mirror”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Interval Wipers”, “availability”:”Standard”}, {“group”:”Mirrors & Windows & Wipers”, “name”:”Rear Window Defogger”, “availability”:”Standard”}, {“group”:”Chassis”, “name”:”Anti-Brake System”, “value”:”Non-Abs \| 4-Wheel ABS”}, {“group”:”Chassis”,”name”:”Steering Type”, “value”:”R&P”}, {“group”:”Chassis”, “name”:”Front Brake Type”, “value”:”Disc”}, {“group”:”Chassis”, “name”:”Rear Brake Type”, “value”:”Drum”}, {“group”:”Chassis”, “name”:”Front Suspension”, “value”:”IND”}, {“group”:”Chassis”, “name”:”Rear Suspension”, “value”:”Semi”}, {“group”:”Chassis”, “name”:”Front Spring Type”,”value”:”Coil”}, {“group”:”Chassis”, “name”:”Rear Spring Type”, “value”:”Coil”}, {“group”:”Chassis”, “name”:”Tires”, “value”:”195\/65r15″}, {“group”:”Interior Dimensions”, “name”:”Front Headroom”, “value”:”39.10 In.”}, {“group”:”Interior Dimensions”, “name”:”Rear Headroom”, “value”:”37.10 In.”}, {“group”:”Interior Dimensions”, “name”:”Front Legroom”, “value”:”41.30 In.”}, {“group”:”Interior Dimensions”, “name”:”Rear Legroom”, “value”:”35.40 In.”}, {“group”:”Interior Dimensions”, “name”:”Front Shoulder Room”, “value”:”53.10 In.”}, {“group”:”Interior Dimensions”, “value”:”53.50 In.”}, {“group”:”Interior Dimensions”, “name”:”Front Hip Room”, “value”:”51.90 In.”}, {“group”:”Interior Dimensions”, “name”:”Rear Hip Room”, “value”:”46.20 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Curb Weight-automatic”, {“group”:”Exterior Dimensions & Weight”, “name”:”Curb Weight-manual”, “value”:”2524 Lbs”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Overall Length”, “value”:”178.30 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Overall Width”, {“group”:”Exterior Dimensions & Weight”, “name”:”Overall Height”, “value”:”58.50 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Wheelbase”, “value”:”102.40 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Ground Clearance”, “value”:”5.70 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Track Front”, “value”:”58.30 In.”}, {“group”:”Exterior Dimensions & Weight”, “name”:”Track Rear”, “value”:”57.50 In.”}, {“group”:”Cargo Bed Dimensions”, “name”:”Overall Length”, {“group”:”Capacities”, “name”:”Standard Seating”, “Value”:”5″}, {“group”:”Capacities”, “name”:”Passenger Volume”, “value”:”90.30 Cu.ft.”}, {“group”:”Capacities”, “name”:”Cargo Volume”, “value”:”13.60 Cu.ft.”}, {“group”:”Capacities”, “name”:”Standard Towing”, “value”:”1500 Lbs”}, {“group”:”Capacities”, “name”:”Maximum Towing”, “value”:”1500 Lbs”}]
recalls	Details about recall information based on the vehicle’s year, make, model, and trim	[{“source”:”NHTSA”, “campaign”:”15V285000″, “date”:”20150513″, “components”:”AIR BAGS”, “summary”:”Toyota Motor Engineering & Manufacturing (Toyota) notified the agency on May 13, 2015 that they are recalling certain model year…”}]
warranties	Details about manufacturer warranties based on the vehicle’s year, make, model, and trim	[{“type”:”Basic”, “miles”:”36,000 miles”, “months”:”36 months”}, {“type”:”Powertrain”, “miles”:”60,000 miles”, “months”:”60 months”}, {“type”:”Rust”, “months”:”60 months”, “miles”:”Unlimited miles”}]
photos	Photos based on the vehicle’s year, make, model, and trim	[{“url”:”https://imgset.info/a/1NXBR38E74Z195377_20190205_0-43001?size=medium”}, {“url”:”https://imgset.info/a/1NXBR32E04Z192720_20190205_0-46560?size=medium”}, {“url”:”https://imgset.info/a/JTDBR32E042024060_20190205_0-44966?size=medium”}]
success	Whether vehicle specifications data exists	true
error	One of the following error codes… invalid_inputs (missing VIN, ID, or year/make/model/trim) invalid_vin (not a valid VIN) no_data (no specifications available) api_not_enabled (functionality not enabled for API key) or (blank) if no error	invalid_vin

Example Request

HTTP

https://specifications.vinaudit.com/v3/specifications?format=xml&key=VA_DEMO_KEY&vin=1NXBR32E85Z505904

Example Response

JSON

<result> <input> <key>VA_DEMO_KEY <year>2004</year> <make>toyota</make> <model>corolla</model> <format>xml</format> </input> <selections> <trims> <trim> <id>2005_toyota_corolla_s</id> <name>S</name> <selected>1</selected> <styles/> </trim> <trim> <id>2005_toyota_corolla_ce</id> <name>CE</name> <styles/> </trim> <trim> <id>2005_toyota_corolla_le</id> <name>LE</name> <styles/> </trim> </trims> </selections> <attributes> <year>2005</year> <make>Toyota</make> <model>Corolla</model> <trim>S</trim> <style/> <type>Car</type> <size>Compact</size> <category>Compact Cars</category> <made_in>America</made_in> <made_in_city>Cambridge</made_in_city> <doors>4</doors> <fuel_type>Regular Unleaded</fuel_type> <fuel_capacity>13.20 gallons</fuel_capacity> <city_mileage>30 – 32 miles/gallon</city_mileage> <highway_mileage>38 – 41 miles/gallon</highway_mileage> <engine>1.8-L L-4 DOHC 16V</engine> <engine_size>1.8-L</engine_size> <engine_cylinders>L-4</engine_cylinders> <transmission>4-Speed Automatic 5-Speed Manual</transmission> <transmission_type>Manual</transmission_type> <transmission_speeds>5-Speed</transmission_speeds> <drivetrain>Front-Wheel Drive</drivetrain> <anti_brake_system>Non-Abs 4-Wheel ABS</anti_brake_system> <steering_type>Rack & Pinion</steering_type> <curb_weight>2590 pounds</curb_weight> <gross_weight>9999 pounds</gross_weight> <gross_vehicle_weight_rating/> <overall_height>58.50 inches</overall_height> <overall_length>178.30 inches</overall_length> <overall_width>66.90 inches</overall_width> <wheelbase_length>102.40 Inches</wheelbase_length> <standard_seating>5</standard_seating> <invoice_price>$13,563</invoice_price> <delivery_charges>$540</delivery_charges> <manufacturer_suggested_retail_price>$14,990</manufacturer_suggested_retail_price> </attributes> <success>1</success> <error/> </result>

Ready to build ?

Access the Market Listings and Market Values APIs with a free developer account. No credit card required.