The Vehicle Specifications 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.
To retrieve a vehicle’s specifications request:
https://specifications.vinaudit.com/v3/specifications?
With GET or POST parameters: When searching by VIN:
| Parameter | Description | Required | Examples |
|---|---|---|---|
| vin | The vehicle identification number | yes | 1NXBR32E85Z505904 |
| include | Type of data to be included in the response | no | selections, attributes, equipment, colors, recalls, warranties, photos |
| key | Your VinAudit API key | yes | VA_DEMO_KEY |
| format | The output format: json or xml | no | json |
When searching by YMMT:
| Parameter | Description | Required | Examples |
|---|---|---|---|
| year | The selected vehicle year | yes | 2004 |
| make | The selected vehicle make | yes | toyota |
| model | The selected vehicle model | yes | corolla |
| trim | The selected vehicle trim | no | ce |
| include | Type of data to be included in the response | no | selections,attributes,equipment,colors,recalls,warranties,photos |
| key | Your VinAudit API key | yes | VA_DEMO_KEY |
| format | The output format: json or xml | no | json |
When searching by ID:
| Parameter | Description | Required | Examples |
|---|---|---|---|
| id | Unique identifier associated with each of the following attribute combinations: year_make_model_trim year_make_model_trim_style | yes | id=2004_toyota_corolla_ce id=2013_bmw_3series_328i_sedan |
| include | Type of data to be included in the response | no | selections, attributes, equipment, colors, recalls, warranties, photos |
| key | Your VinAudit API key | yes | VA_DEMO_KEY |
| format | The output format: json or xml | no | json |
Response elements:
| Elements | Description | Example |
|---|---|---|
| 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”}] |
| 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 1: Get by VIN (successful request XML)
Request:
https://specifications.vinaudit.com/v3/specifications?format=xml&key=VA_DEMO_KEY&vin=1NXBR32E85Z505904
Response elements:
<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>
Example 2: Get by year, make, model, and trim (successful request JSON)
Request:
https://specifications.vinaudit.com/v3/specifications?format=json&key=VA_DEMO_KEY&year=2005&make=toyota&model=corolla&trim=ce
Response:
{“input”:{“key”:”VA_DEMO_KEY”,”year”:”2005″,”make”:”toyota”,”model”:”corolla”,”trim”:”ce”,”format”:”json”},”selections”:{“trims”:[{“id”:”2005_toyota_corolla_ce”,”name”:”CE”,”selected”:1,”styles”:[]}]},”attributes”:{“year”:”2005″,”make”:”Toyota”,”model”:”Corolla”,”trim”:”CE”,”style”:””,”type”:”Car 2″,”size”:”Compact”,”category”:”Compact Cars”,”made_in”:”America”, “made_in_city”:”Cambridge”,”doors”:”5″,”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”,”drivetrain”:”Front-Wheel Drive”,”anti_brake_system”:”Non-ABS 4-Wheel ABS”,”steering_type”:”Rack & Pinion”,”curb_weight”:”2590 pounds”,”gross_vehicle_weight_rating”:””,”overall_height”:”58.50 inches”,”overall_length”:”178.30 inches”,”overall_width”:”66.90 inches”,”wheelbase_length”:”102.40 inches”,”standard_seating”:”5″,”invoice_price”:”$13,563″,”delivery_charges”:”$540″,”manufacturer_suggested_retail_price”:”$14,990″},”success”:true,”error”:””}
Example 3: Get by ID (successful request XML)
Request:
https://specifications.vinaudit.com/v3/specifications?format=xml&key=VA_DEMO_KEY&id=2004_toyota_corolla_ce&include=selections,attributes,warranties,photos
Response:
<result> <input> <key>VA_DEMO_KEY <year>2004</year> <make>toyota</make> <model>corolla</model> <format>xml</format> <include>selections,attributes,warranties,photos</include> </input> <selections> <trims> <trim> <id>2004_toyota_corolla_ce</id> <name>CE</name> <selected>1</selected> <styles/> </trim> </trims> </selections> <attributes> <year>2004</year> <make>Toyota</make> <model>Corolla</model> <trim>CE</trim> <style/> <type>Sedan 4-Door</type> <size>Compact</size> <category>Compact Cars</category> <made_in>Japan</made_in> <made_in_city>Takaoka</made_in_city> <doors>4</doors> <fuel_type>Regular Unleaded</fuel_type> <fuel_capacity>13.20 gallons</fuel_capacity> <city_mileage>29 – 32 miles/gallon</city_mileage> <highway_mileage>38 – 40 miles/gallon</highway_mileage> <engine>1.8-L L-4 DOHC <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_vehicle_weight_rating/> <overall_height>58 inches</overall_height> <overall_length>178 inches</overall_length> <overall_width>66 inches</overall_width> <standard_seating>5</standard_seating> <invoice_price>$13,374</invoice_price> <delivery_charges>$515</delivery_charges> <manufacturer_suggested_retail_price>$14,780</manufacturer_suggested_retail_price> </attributes> <warranties> <warranty> <type>Basic</type> <months>36 Months</months> <miles>36,000 miles</miles> </warranty> <warranty> <type>Powertrain</type> <months>60 Months</months> <miles>60,000 miles</miles> </warranty> <warranty> <type>Rust</type> <months>60 Months</months> <miles>unlimited miles</miles> </warranty> </warranties> <photos> <photo> <url> https://imgset.info/a/2T1BR32E84C194054_20190205_0-36007?size=medium </url> </photo> <photo> <url> https://imgset.info/a/1NXBR32E34Z241831_20190205_0-141785?size=medium </url> </photo> <photo> <url> https://imgset.info/a/1NXBR32E04Z192720_20190205_0-46560?size=medium </url> </photo> <photo> <url> https://imgset.info/a/1NXBR38E74Z195377_20190205_0-43001?size=medium </url> </photo> <photo> <url> https://imgset.info/a/JTDBR32E042024060_20190205_0-44966?size=medium </url> </photo> </photos> <success>1</success> <error/> </result>
</code>
Example 4: Get by VIN (invalid VIN request JSON)
Request:
https://specifications.vinaudit.com/v3/specifications?format=json&key=VA_DEMO_KEY&vin=1NXBR32E85Z50590Q
Response:
{"input":{"key":"VA_DEMO_KEY","vin":"1NXBR32E85Z50590Q"},"success":false,"error":"invalid_vin"}