DOCUMENTATION: Vehicle History API

Vehicle History API Overview

The Vehicle History API enables access to the raw vehicle history data behind the VinAudit Vehicle History Report, covering both the United States and Canada. It requires an API bulk access account configured to include the desired response parameters. With an API-enabled account you can login to access your API key. From there, your application can access data by making HTTPS requests to our API server (api.vinaudit.com). The output can be formatted in JSON, XML, or downloaded as a PDF. Full documentation below.

There are three API services documented below:

Service #1: Query a VIN for Records
Service #2: Generate a Vehicle History Report
Service #3: View a Generated Vehicle History Report

Service #1: Query a VIN for Records

If you need to look up the vehicle’s past records and gain access to a lot of information, a vehicle history VIN decoder API can provide data such as country of origin, manufacturer, model, body style, engine, and vehicle type. It can decode Vehicle Identification Numbers (VINs) from model years 1981 up to the present.

Documentation

To query whether data for a VIN exists, request:

https://api.vinaudit.com/v2/query

With GET or POST parameters:

Parameter	Description	Required	Example
vin	The vehicle identification number	Yes	1VXBR12EXCP901214
key	Your account’s API key	Yes	VA_DEMO_KEY
user	The account username	Yes	va
pass	The account password	Yes	test
format	Output format (json or xml)	Yes	json
skipspec	Set to 1 if attributes are not needed	(optional)	1
mode	Set to test for development (test VINs only)	(optional)	test
callback	A javascript callback method name	(optional)	OnVinQueryData

Response attributes:

Parameter	Description	Example
id	A unique report ID to use for pulling full history	T61381187049
vin	The vehicle identification number	1VXBR12EXCP901214
attributes	A map of attributes about the VIN (make, model, style, engine, made_in, type)	{“vin”:”1VXBR12EXCP901214″, ”make”:”TOYOTA”, ”model”:”COROLLA CE”, ”style”:”Sedan (4-Door)”, ”engine”:”1.8L L4 DOHC 16V”, ”made_in”:”JAPAN”, ”type”:”PASSENGER CAR”}
success	Whether records exist in NMVTIS One of: true: Report was successfully generated false: An error occurred while generating the report	true
error	One of: invalid_vin: Not a valid 17-digit VIN unexpected_input: Report ID does not match VIN no_records: No records found for VIN failed_request: Authorization process failed unauthorized_request: Invalid API Key/Username/Password expired_report: Report expired. Please request a new one missing_report: Report not initialized. Please request a new one. or blank if no error	(blank)

Examples

Example #1. (successful request)

Request:

https://api.vinaudit.com/v2/query?vin=1VXBR12EXCP901214&key=VA_DEMO_KEY&format=json

Response:

{"vin":"1VXBR12EXCP901214","id":"S41149125266","attributes":{"vin":"1VXBR12EXCP901214","year":"2005","make":"TOYOTA","model":"COROLLA CE","style":"SEDAN (4-Door)","engine":"1.8L L4 DOHC 16V","made_in":"JAPAN","type":"PASSENGER CAR"},"success":true,"error":""}

Example #2. (unsuccessful request)

Request:

https://api.vinaudit.com/v2/query?vin=1VXBR12EXCP901214&key=VA_DEMO_KEY&format=json

Response:

{"vin":"1VXBR12EXCP901214","success":false,"error":"invalid_vin","error_message":"Not a valid 17-digit VIN."}

Source Code

FILE NAME	Description
vinaudit_client_php.zip	PHP Client Library for VinAudit APIs	Download

Service #2: Generate a Vehicle History Report

Checking the VIN number will give you access to a detailed vehicle history report. Some of the vehicle history data you can get are title status, odometer reading, title brand, whether it has liens, active theft and recovery records, accident and collision history, salvage records, past sale listings, and if any recalls were issued. These are all the important details a used car buyer should be aware of.

Documentation

To generate the vehicle history report for a VIN, request:

https://api.vinaudit.com/v2/pullreport

With GET or POST parameters:

Parameter	Description	Required	Example
id	A unique report ID for this report request	Yes
vin	The vehicle identification number	Yes	1VXBR12EXCP901214
user	Your account username	Yes	va
pass	Your account password*	Yes	test
key	Your account API key	Yes	VA_DEMO_KEY
format	Output format (json, xml, or pdf)	Yes	json
mode	Set to test for development	(optional)	test
type	Set to (USA or CAN); requires format=pdf	(optional)	CAN
brand	Set to 0 to produce unbranded PDF; requires format=pdf	(optional)	1
lang	Set to language code (en, es) for translated PDF; requires format=pdf	(optional)	en
callback	A javascript callback method name; requires format=json	(optional)

Response attributes:

Parameter	Description	Example
id	The unique report identifier	T46848493729
vin	The vehicle identification number	1VXBR12EXCP901214
date	The date and time the report was pulled	2020-07-10 14:07:09 PDT
attributes	A dynamic map of available vehicle attributes	{“vin”:”1VXBR12EXCP901214″, “year”:”2005″, “make”:”Toyota”, “model”:”Corolla”, “trim”:”CE”, “engine”:”1.8L L4 DOHC 16V”, “made_in”:”Japan”, “style”:”Sedan (4-Door)”, “steering_type”:”R&P”, “anti-brake_system”:”4-Wheel ABS”, “fuel_type”:”regular unleaded”, “fuel_capacity”:”17.00 gallons”, “gross_vehicle_weight_rating”:”5070″, “overall_height”:”58.50 in.”, “overall_length”:”178.30 in.”, “overall_width”:”66.90 in.”, “standard_seating”:”5″, “optional_seating”:”No data”, “highway_mileage”:”38 – 41 miles/gallon”, “city_mileage”:”30 – 32 miles/gallon”, “invoice_price”:”$22,275″, “manufacturer_suggested_retail_price”: “$23,900”]
titles	A list of title records with the format: date: The title record date state: The 2-letter code for the issuing state vin: The recorded VIN (may be old VIN) meter: The odometer reading meter_unit: ‘M’ for miles, ‘K’ for kilometers current: Whether the title record is current, not historical	[{‘date’:’2011-08-31′, ‘state’:’WA’, ‘vin’:’1VXBR12EXCP901214′, ‘meter’:’59396′, ‘meter_unit’:’M’, ‘current’:true}, {‘date’:’2008-02-23′, ‘state’:’WI’, ‘vin’:’1VXBR12EXCP901214′, ‘meter’:’37398′, ‘meter_unit’:’M’, ‘current’:false}]
jsi	A list of Junk/Salvage/Insurance records, each with attributes: date: The brand date record_type: The type of record. List of values: ‘Junk and Salvage’, ‘Insurers’. brander_code: The brander’s code. brander_name: The brander’s name. brander_city: The brander’s city. brander_state: The brander’s state. brander_email: The brander’s email. brander_phone: The brander’s phone. vehicle_disposition: The vehicle’s reported disposition. List of values: ‘SCRAP’, ‘CRUSH’, ‘SOLD’, ‘PARTS’ (dismantled for parts), ‘RETAINED’ (owner-retained) or ‘TO BE DETERMINED’. intended_for_export: Whether the vehicle is intended for export.	[{“date”:”2007-10-25″, “record_type”:”Junk And Salvage”, “brander_code”:”P000001″, “brander_name”:”Insurance Salvage, Inc.”, “brander_city”:”Milwaukee”, “brander_state”:”WI”, “brander_email”:””, “brander_phone”:”5556478921″, “vehicle_disposition”:”SOLD”, “intended_for_export”:”NO”}]
lie	A list of lien, impound, and export records (available as add-on): record_type: One of: Lien, Impound, Export date: The date of the event. state: The US State in which the event occurred (if available) status: The status of the vehicle (if available) agency: The entity associated with the event (if available) vin: The VIN associated with the event (for confirmation)	[{“record_type”: “Lien”, “vin”: “1VXBR12EXCP901214”, “date”: “2015-05-23”, “agency”: “Loan Agency, Inc.”}]
thefts	A list of theft or theft recovery records (available as add-on): record_type: List of values: Theft (reported stolen), Theft Recovery (reported recovered after stolen), Theft Report Withdrawn (previous theft report invalidated), Theft Recovery Withdrawn (previous theft recovery report invalidated) date: The date of the record. theft_status: Whether theft is “Active” or “Inactive” theft_reported_date: The date the theft was reported theft_reported_state: The 2-letter state code in which the theft was reported vehicle_year: The 2-digit year of the vehicle reported stolen (if available) vehicle_make: The make of the vehicle reported stolen (if available) vehicle_model: The model of the vehicle reported stolen (if available) source_name: The name of the reporting entity (ex: National Insurance Crime Bureau). source_phone: The phone number of the reporting entity (ex: 800-447-6282). source_website: The website of the reporting entity (ex: www.nicb.org). source_city: The city of the reporting entity (ex: Des Plaines). source_state: The state code of the reporting entity (ex: IL). source_zip: The 5-digit zip code of the reporting entity (ex: 60018).	[{“vin”: “1VXBR12EXCP901214”, “date”: “2014-11-28”, “theft_status”: “Inactive”, “theft_reported_state”: “NJ”, “report_id”: “9L003768767”, “vehicle_year”: “05”, “vehicle_make”: “TOYOTA”, “date_of_theft”: “2014-11-28”, “date_of_recovery”: “2015-04-15”, “record_type”: “Theft Recovery”, “source_name”: “National Insurance Crime Bureau”, “source_phone”: “8004476282”, “source_website”: “www.nicb.org”, “source_city”: “Des Plaines”, “source_state”: “IL”, “source_zip”: “60018”, “source”: “nicb”}]
accidents	A list of accident records (available as add-on): date: The date of the record. type: The type of record (must be “accident”). report_id: The unique report identification number (if available). vehicle_year: The year the vehicle was manufactured (if available). vehicle_make: The manufacturer of the vehicle (if available). vehicle_model: The model of the vehicle (if available). vehicle_style: The style of the vehicle (if available). vehicle_color: The color of the vehicle (if available). vehicle_type: The body style of the vehicle (if available). license_state: The state the vehicle was registered in at time of accident (if available). damage_severity: The extent of the vehicle’s damage (if available). estimated_damage: The financial estimate of the vehicle’s damage (if available). estimated_speed: The estimated speed at which the vehicle impact occured (if available). crash_severity: The severity of the accident as reported by source (if available). posted_speed: The posted speed limit where the accident occured (if available). manner_of_collision: The manner of vehicle collision (ex. front to rear). impact_area: The area of the vehicle where the impact occurred (if available). insurance_company: The insurance company associated with the vehicle at the time of accident (if available). reporting_agency: The agency that reported the accident (if available). crash_location: The location of the accident (if available). airbags_deployed: Airbag deployment indicator (if available). object_struck: The type of object which the vehicle had struck (if available). source_name: The name of the reporting entity (ex. Arizona Dept of Public Safety). source_phone: The phone number of the reporting entity (ex. 602-223-2000). source_website: The website of the reporting entity (ex. www.azdps.gov). source_city: The city of the reporting entity (ex. Phoenix). source_state: The state code of the reporting entity (ex. AZ). source_zip: The 5-digit zip code of the reporting entity (ex. 85009). source: VinAudit internal source name (ex. az_crash).	[{“vin”:”1VXBR12EXCP901214″, “date”:”2015-02-08″, “type”:”accident”, “report_id”:”170839″, “vehicle_year”:”2005″, “vehicle_make”:”TOYOTA”, “vehicle_style”:”4 DOOR SEDAN”, “manner_of_collision”:”REAR END”, “source_name”:”Crash Data Source, Inc.”, “source_phone”:”7689271872″, “source_website”:”crashdatasource-inc.com”, “source_city”:”Los Angeles”, “source_state”:”CA”, “source_zip”:”98001″, “source”:”cds_crash”}]
salvage	A list of salvage records (available as add-on): date: The date of the record. type: The type of record (ex. salvage). listing_id: The unique listing identification number for the salvage auction (if available). location: The location of the vehicle (if available). primary_damage: Description of primary damage associated with vehicle (ex. rear end). secondary_damage: Description of secondary damage associated with vehicle (if available). odometer: The listed odometer reading, as reported by source (if available). sale_document: Description of associated documentation (ex. CA – salvage certificate) estimated_damage: The estimated financial damage of the vehicle (if available). exterior_color: The exterior color of the vehicle (if available).	[{“vin”:”1VXBR12EXCP901214″, “date”:”2015-08-30″, “type”:”salvage”, “listing_id”:”475661892″, “location”:”WA – SEATTLE”, “primary_damage”:”REAR END”, “secondary_damage”:”FRONT END”, “odometer”:”24301.0 mi (ACTUAL)”, “sale_document”:”WA – SALVAGE CERTIFICATE”, “exterior_color”:”CHARCOAL”}]
sale	A list of sale records (available as add-on): date: The date of the record. type: The type of record (must be “sale”). listing_price: The listed price of the vehicle (if available). vehicle_mileage: The listed mileage of the vehicle (if available). vehicle_year: The listed year that the vehicle was manufactured (if available). vehicle_color: The listed exterior color of the vehicle (if available). seller_type: The type of seller that has listed the vehicle for sale (ex: dealer). seller_name: The name of the seller that has listed the vehicle for sale (if available). seller_city: The city of the seller that has listed the vehicle for sale (if available) seller_state: The state of the seller that has listed the vehicle for sale (if available). seller_zip: The zip code of the seller that has listed the vehicle for sale (if available).	[{“vin”:”1VXBR12EXCP901214″, “date”:”2014-12-02″, “type”:”sale”, “listing_price”:”$8,988″, “vehicle_color”:”Charcoal”, “seller_type”:”Dealer”, “seller_name”:”Lee Toyota”, “seller_city”:”MIAMI”, “seller_state”:”FL”, “seller_zip”:”33101″}]
checks	A list of brand records with the format: date: The title brand date. brand_code: The brand code brander_type: The brander’s type. List of values: ‘State’ brander_name: The brander’s abbreviation (two-letter state code) disposition: The vehicle’s reported disposition	[{“brander_code”: “NY”, “brander_name”: “NEW YORK”, “brand_code”: “11”, “date”: “2015-02-10”, “brander_type”: “State”}]
canada_registrations	A list of Canadian registration records with the format: jurisdiction: The province with the vehicle is registered status: The vehicle’s status status_date: The date of the reported status registration_date: The date of registration registration_odometer: The odometer reading at the time of registration registration_expiry_date: The date the registration expires registration_odometer_unit: The unit of measurement used to record the vehicle odometer	[{“jurisdiction”:”ON”, “status”:”normal”, “status_date”:”2020-01-14″, “registration_date”:”2020-01-14″, “registration_odometer”:”055733″, “registration_expiry_date”:””, “registration_odometer_unit”:”K”}]
canada_recalls	A list of Canadian recall records with the format: recall_number: The recall ID recall_date: The date the recall was issued affected_system: The vehicle sytem affected by the recall notification_type: The type of notification manufacturer_recall_number: The recall number assinged by the manufacturer units_affected: The number of units effected category: The vehicle type classification recall_details: The description of the recall manufacturer_name: The vehicle manufacturer’s name toll_free_number: Where to call for additoinal recall information website: Where to visit for additional recall information	[{“recall_number”:”2018587″, “recall_date”:”2018-10-26″, “affected_system”:”Engine”, “notification_type”:”Safety MFR”, “manufacturer_recall_number”:””, “units_affected”:”10,368″, “category”:”Car, SUV”, “recall_details”:”ON Certain Vehicles, THE Cooler…, “manufacturer_name”:”BMW”, “toll_free_number”:”1-800-567-2691″, “website”:”Https://Crm.bmw.ca/en-Ca/vehiclerecall”}]
canada_thefts	A list of Canadian theft records with the format: vin: The vehicle identification number vehicle_type: The type of vehicle license_number: The vehicle license plate number province: The province where the vehicle is registered vehicle_make: The make of the vehicle vehicle_year: The year the vehicle was manufactured license_year: The year the vehicle was licensed reported_stolen_in: The province where the vehicle was reported stolen date_modified: The date the record was modified	[{“vin”:”1VXBR12EXCP901213″, “vehicle_type”:”car”, “license_number”:”AAH104″, “province”:”ON”, “vehicle_make”:”Toyota”, “vehicle_model”:”Corolla”, “vehicle_year”:”2005″, “license_year”:”2019″, “reported_stolen_in”:”ON”, “date_modified”:”2014-05-07″}]
clean	Whether the report is free of title brands, salvage, and insurance records One of: true: Report is free of title brands, salvage, and insurance records false: Report contains title brands, salvage, insurance records	true
success	Whether the report has been generated One of: true: Report was successfully generated false: An error occurred while generating the report	true
error	One of: invalid_vin: Not a valid 17-digit VIN failed_request: Authorization process failed unauthorized_request: Invalid API Key/Username/Password incomplete_report: NMVTIS database unavailable expired_report: Report expired. Please request a new one missing_report: Report not initialized. Please request a new one. or blank if no error	(blank)

Response attributes (if failure):

Parameter	Description	Example
vin	The vehicle identification number	1VXBR12EXCP901214
success	Whether the report has been generated One of: true: Report was successfully generated false: An error occurred while generating the report	true
error	One of: invalid_vin: Not a valid 17-digit VIN failed_request: Authorization process failed unauthorized_request: Invalid API Key/Username/Password incomplete_report: NMVTIS database unavailable expired_report: Report expired. Please request a new one missing_report: Report not initialized. Please request a new one. or blank if no error	invalid_vin

Examples

Example #1 (no records, XML):

Request:

https://api.vinaudit.com/v2/pullreport?id=00000000000001&key=MY_KEY&vin=1VXBR12EXCP901214&mode=&user=MY_USER&pass=MY_PASS&format=xml

Response:

<result>
   <vin>1VXBR12EXCP901214</vin>
   <id>00000000000001</id>
   <attributes>
      <vin>1VXBR12EXCP901214</vin>
   </attributes>
<success>0</success>
<error>failed_request</error>
<error_message>No records found.</error_message>
</result>

Example #2 (full report data, json):

Request:

https://api.vinaudit.com/v2/pullreport?id=00000000000002&key=MY_KEY&vin=1VXBR12EXCP901214&mode=test&user=MY_USER&pass=MY_PASS&format=json

Response:

{"vin":"1VXBR12EXCP901214","id":"00000000000002","date":"2018-03-02 09:47:20 PST","attributes":{"vin":"1VXBR12EXCP901214","year":"2005","make":"Toyota","model":"Corolla","trim":"CE","engine":"1.8L L4 DOHC 16V","style":"Sedan (4-Door)","type":"PASSENGER CAR","made_in":"JAPAN","steering_type":"R&P","anti-brake_system":"4-Wheel ABS","overall_height":"58.50 Inches","overall_length":"178.30 Inches","overall_width":"66.90 Inches","standard_seating":"5","highway_mileage":"38 - 41 miles\/gallon","city_mileage":"30 - 32 miles\/gallon"},"titles":[{"date":"2011-08-31","state":"WA","vin":"1VXBR12EXCP901214","meter":"59396","meter_unit":"M","current":"true"},{"date":"2008-02-23","state":"WA","vin":"1VXBR12EXCP901214","meter":"37398","meter_unit":"M","current":"false"}],"jsi":[{"date":"2007-10-25","record_type":"Junk And Salvage","brander_code":"P000001","brander_name":"Insurance Salvage, Inc.","brander_city":"Milwaukee","brander_state":"WI","brander_email":"","brander_phone":"5556478921","vehicle_disposition":"SOLD","intended_for_export":"NO"}],"lien":[{"record_type":"Lien","vin":"1VXBR12EXCP901214","date":"2015-05-23","agency":"Loan Agency, Inc."}],"thefts":[{"vin":"1VXBR12EXCP901214","date":"2014-11-28","theft_status":"Inactive","theft_reported_state":"NJ","report_id":"9L003768767","vehicle_year":"05","vehicle_make":"TOYOTA","date_of_theft":"2014-11-28","date_of_recovery":"2015-04-15","record_type":"Theft Recovery","source_name":"National Insurance Crime Bureau","source_phone":"8004476282","source_website":"www.nicb.org","source_city":"Des Plaines","source_state":"IL","source_zip":"60018","source":"nicb"}],"accidents":[{"vin":"1VXBR12EXCP901214","date":"2015-02-08","type":"accident","repord_id":"170839","vehicle_year":"2005","vehicle_make":"TOYOTA","vehicle_style":"4 DOOR SEDAN","manner_of_collision":"REAR END","source_name":"Crash Data Source, Inc.","source_phone":"7689271872","source_website":"crashdatasource-inc.com","source_city":"Los Angeles","source_state":"CA","source_zip":"98001","source":"cds_crash"}],"salvage":[{"vin":"1VXBR12EXCP901214","date":"2015-08-30","type":"salvage","listing_id":"475661892","location":"WA - SEATTLE","primary_damage":"REAR END","secondary_damage":"FRONT END","odometer":"24301.0 mi (ACTUAL)","sale_document":"WA - SALVAGE CERTIFICATE","exterior_color":"CHARCOAL"}],"sale":[{"vin":"1VXBR12EXCP901214","date":"2014-12-02","type":"sale","listing_price":"$8,988","vehicle_color":"Charcoal","seller_type":"Dealer","seller_name":"Lee Toyota","seller_city":"MIAMI","seller_state":"FL","seller_zip":"33101"}],"checks":[{"brand_code":"11","brander_type":"State","brander_code":"NY","brander_name":"NEW YORK","date":"2015-02-10"}],"success":true,"error":""}

Example #3 (report PDF):

Request:

https://api.vinaudit.com/v2/pullreport?id=00000000000003&key=MY_KEY&vin=1VXBR12EXCP901213&mode=test&user=MY_USER&pass=MY_PASS&format=pdf

Response:

View Sample

Source Code

FILE NAME	Description
vinaudit_client_php.zip	PHP Client Library for VinAudit APIs	Download

Service #3: View a Generated Vehicle History Report

You can read the car’s history when you generate a vehicle history report. It provides insights about a vehicle’s past and can tell you if a car is a lemon. This will help consumers buy a reliable used car. For vehicle record searches, such as registration and title records, you can obtain a vehicle history report DMV.

Documentation

To view data from a vehicle history report that already exists, request:

https://api.vinaudit.com/v2/report

With GET or POST parameters:

Parameter	Description	Required	Example
id	The report id	Yes	182896361699
key	YourVinAudit.com API key	Yes	VA_DEMO_KEY
format	Response format(json, pdf, or xml)	Yes	json
type	Set to (USA or CAN); requires format=pdf	(optional)	CAN
brand	Set to 0 to produce unbranded PDF; requires format=pdf	(optional)	1
lang	Set to language code (en, es) for translated PDF; requires format=pdf	(optional)	en
skipspec	Set “1” if attributes aren’t needed	(optional)	1
mode	Set to “test” for development	(optional)	test
callback	Javascript callback method	(optional)

Response attributes:

Parameter	Description	Example
id	The report identifier	182896361699
vin	The vehicle identification number	1NXBR32E85Z505904
attributes	A dynamic map of available vehicle attributes	{“vin”:”1VXBR12EXCP901214″, “year”:”2005″, “make”:”Toyota”, “model”:”Corolla”, “trim”:”CE”, “engine”:”1.8L L4 DOHC 16V”, “made_in”:”Japan”, “style”:”Sedan (4-Door)”, “steering_type”:”R&P”, “anti-brake_system”:”4-Wheel ABS”, “fuel_type”:”regular unleaded”, “fuel_capacity”:”17.00 gallons”, “gross_vehicle_weight_rating”:”5070″, “overall_height”:”58.50 in.”, “overall_length”:”178.30 in.”, “overall_width”:”66.90 in.”, “standard_seating”:”5″, “optional_seating”:”No data”, “highway_mileage”:”38 – 41 miles/gallon”, “city_mileage”:”30 – 32 miles/gallon”, “invoice_price”:”$22,275″, “manufacturer_suggested_retail_price”: “$23,900”]
jsi	An list of Junk/Salvage/Insurance records, each with attributes: date: The brand date record_type: The type of record. brander_name: The brander’s name. brander_city: The brander’s city. brander_state: The brander’s state. brander_email: The brander’s email. brander_phone: The brander’s phone. vehicle_disposition: The vehicle’s reported disposition. List of values: ‘SCRAP’, ‘CRUSH’, ‘SOLD’, ‘PARTS’ (dismantled for parts), ‘RETAINED’ (owner-retained) or ‘TO BE DETERMINED’. intended_for_export: Whether the vehicle is intended for export.	[{“date”:”2007-10-25″, “record_type”:”Junk And Salvage”, “brander_code”:”P000001″, “brander_name”:”Insurance Salvage, Inc.”, “brander_city”:”Milwaukee”, “brander_state”:”WI”, “brander_email”:””, “brander_phone”:”5556478921″, “vehicle_disposition”:”SOLD”, “intended_for_export”:”NO”}]
checks	An list of brand records with the format: date: The title brand date. brand_code: The brand code brander_type: The brander’s type brander_name: The brander’s namedisposition: The vehicle’s reported disposition	[{“brander_code”: “NY”, “brander_name”: “NEW YORK”, “brand_code”: “11”, “date”: “2015-02-10”, “brander_type”: “State”}]
titles	An list of title records with the format: date: The title record state: The 2-letter code for the issuing vin: The recorded VIN (may be old VIN) meter: The odometer reading meter_unit: ‘M’ for miles, ‘K’ for kilometers current: Whether the title record is current, not historical	[{‘date’:’2011-08-31′, ‘state’:’WA’, ‘vin’:’1VXBR12EXCP901214′, ‘meter’:’59396′, ‘meter_unit’:’M’, ‘current’:true}, {‘date’:’2008-02-23′, ‘state’:’WI’, ‘vin’:’1VXBR12EXCP901214′, ‘meter’:’37398′, ‘meter_unit’:’M’, ‘current’:false}]
canada_registrations	A list of Canadian registration records with the format: jurisdiction: The province with the vehicle is registered status: The vehicle’s status status_date: The date of the reported status registration_date: The date of registration registration_odometer: The odometer reading at the time of registration registration_expiry_date: The date the registration expires registration_odometer_unit: The unit of measurement used to record the vheicle odometer	[{“jurisdiction”:”ON”, “status”:”normal”, “status_date”:”2020-01-14″, “registration_date”:”2020-01-14″, “registration_odometer”:”055733″, “registration_expiry_date”:””, “registration_odometer_unit”:”K”}]
canada_recalls	A list of Canadian recall records with the format: recall_number: The recall ID recall_date: The date the recall was issued affected_system: The vehicle sytem affected by the recall notification_type: The type of notification manufacturer_recall Number: The recall number assinged by the manufacturer units_affected: The number of units effected category: The vehicle type classification recall_details: The description of the recall manufacturer_name: The vehicle manufacturer’s name toll_free_number: Where to call for additoinal recall information website: Where to visit for additional recall information	[{“recall_number”:”2018587″, “recall_date”:”2018-10-26″, “affected_system”:”Engine”, “notification_type”:”Safety MFR”, “manufacturer_recall_number”:””, “units_affected”:”10,368″, “category”:”Car, SUV”, “recall_details”:”ON Certain Vehicles, THE Cooler…, “manufacturer_name”:”BMW”, “toll_free_number”:”1-800-567-2691″, “website”:”Https://Crm.bmw.ca/en-Ca/vehiclerecall”}]
canada_thefts	A list of Canadian theft records with the format: vin: The vehicle identification number vehicle_type: The type of vehicle license_number: The vehicle license plate number province: The province where the vehicle is registered vehicle_make: The make of the vehicle vehicle_year: The year the vehicle was manufactured license_year: The year the vehicle was licensed reported_stolen_in: The province where the vehicle was reported stolen date_modified: The date the record was modified	[{“vin”:”1VXBR12EXCP901213″, “vehicle_type”:”car”, “license_number”:”AAH104″, “province”:”ON”, “vehicle_make”:”Toyota”, “vehicle_model”:”Corolla”, “vehicle_year”:”2005″, “license_year”:”2019″, “reported_stolen_in”:”ON”, “date_modified”:”2014-05-07″}]
success	Whether the report has been generated One of: true: Report was successfully generated false: An error occurred while generating the report	true
error	One of: expired_report: Report expired. Please request a new one missing_report: Report not initialized. Please request a new one. or blank if no error	expired_report

Examples

Example #1. (successful request)

Request:

https://api.vinaudit.com/v2/report?id=94132583912&format=json

Response:

{"success":true,"error":"","id":"31919508431","vin":"1VXBR12EXCP901213","date":"2011-12-21 21:12:15 PST","attributes":{"vin":"1VXBR12EXCP901213","year":"2005","make":"Toyota","model":"Corolla","trim":"CE","engine":"1.8L L4 DOHC 16V","style":"SEDAN 4-DR","made_in":"UNITED STATES","steering_type":"R&P","anti-brake_system":"4-Wheel ABS","tank_size":"13.20 gallon","overall_height":"58.50 in.","overall_length":"178.30 in.","overall_width":"66.90 in.","standard_seating":"5","optional_seating":"No data","highway_mileage":"38 - 41 miles\/gallon","city_ mileage":"30 - 32 miles\/gallon"},"jsi":[{'date': '10/25/2007','record_type':'Junk And Salvage','brander_name':'Insurance Salvage, Inc.','brander_city':'Milwalkee','brander_state':'WI','brander_email':'','brander_phone': '5556478921','vehicle_disposition':'Sold','intended_for_export':'No'}],"checks":[ {'brand_code': '11', 'brander_type': 'State', 'brander_name': 'Ohio', 'disposition': 'Salvage', 'date': '08/02/2005' }, {'brand_code': '09', 'brander_type': 'State', 'brander_code': '', 'brander_name': 'Ohio', 'disposition': 'Rebuilt', 'date': '08/19/2005' } ],"titles": [ {'date': '08/31/2011', 'state':'WA', 'vin':'', 'meter':'59,396', 'meter_unit':'M', 'current': true}, {'date': '02/23/2008', 'state':'WI', 'vin':'1VXBR12EXCP901213', 'meter':'37,398', 'meter_unit':'M', 'current': false}, {'date': '11/04/2007', 'state':'WI', 'vin':'1VXBR12EXCP901213', 'meter':'12,269', 'meter_unit':'M', 'current': false}, {'date': '08/19/2005', 'state':'OH', 'vin':'1VXBR12EXCP153842', 'meter':'3,220', 'meter_unit':'M', 'current': false}, {'date': '06/22/2005', 'state':'OH', 'vin':'1VXBR12EXCP153842', 'meter':'', 'meter_unit':'M', 'current': false} ]}

Example #2. (unsuccessful request)

Request:

https://api.vinaudit.com/v2/report?id=194132583912&format=json

Response:

{"success":false,"error":"missing_report","error_message":"Report not initialized. Please request a new one."}

Source Code

FILE NAME	Description
vinaudit_client_php.zip	PHP Client Library for VinAudit API’s	Download

Implementation Notes:

This request can be re-issued repeatedly using the same ID and VIN.
Your API account is billed at most once for each unique report ID.
Once generated, re-issuing the request will return the cached report data.
The API may return the error message “NMVTIS database unavailable. Please retry later!” during the following scheduled maintenance times for the NMVTIS database: 1am-2am ET daily and 2am-5am ET Sundays.
Additional references: List of Brand Codes, List of State Codes

DOCUMENTATION: Vehicle History API

Vehicle History API Overview

Service #1: Query a VIN for Records

Example #1. (successful request)

Example #2. (unsuccessful request)

Service #2: Generate a Vehicle History Report

Example #1 (no records, XML):

Example #2 (full report data, json):

Example #3 (report PDF):

Service #3: View a Generated Vehicle History Report

Example #1. (successful request)

Example #2. (unsuccessful request)

The most comprehensive Automotive Data & Analytics

SERVICES

RESOURCES

CUSTOMERS

ABOUT US

, Inc.