US
CA
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
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 | true |
| error | One of:
invalid_vin unexpected_input failed_request unauthorized_request incomplete_report or blank if no error |
(blank) |
| error_message | One of:
Not a valid 17-digit VIN. Report ID does not match VIN. Invalid API Key / Invalid username or password. NMVTIS database unavailable. Please retry later! Account rate limit reached. Please try again later! Account disabled. Failed to load data for: attributes, accidents. Please retry! or blank if no error |
(blank) |
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."}
Available Source Code Resources
| FILE NAME | Description | |
|---|---|---|
| vinaudit_client_php.zip | PHP Client Library for VinAudit APIs |
Service #2: Retrieve a Vehicle History Report
To retrieve the NMVTIS data for a VIN (if such data exists), 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. 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 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″}] |
| clean | Whether the report is free of title brands, salvage, and insurance records | true |
| success | Whether the report has been generated | true |
| error | blank if no error (see below for possibilities) | (blank) |
Response attributes (if failure):
| Parameter | Description | Example |
|---|---|---|
| vin | The vehicle identification number | 1VXBR12EXCP901214 |
| success | Whether the report has been generated | false |
| error |
One of: invalid_vin incomplete_report unexpected_input failed_request expired_report unauthorized_request incomplete_report or blank if no error |
invalid_vin |
| error_message |
One of: Not a valid 17-digit VIN. NMVTIS database unavailable. Please retry later! No records found. Report ID does not match VIN. Authorization process failed. Please try again later! Report expired. Please request a new one. Invalid API Key / Invalid username or password. Failed to load data for: attributes, accidents. Please retry! Failed to load data for: [output section name]. Please retry! Report balance inquiry failed. Insufficient report balance. Report expired. Please request a new one. Account disabled. or blank if no error |
Not a valid 17-digit VIN. |
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"}],"lie":[{"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
Available Source Code Resources
| FILE NAME | Description | |
|---|---|---|
| vinaudit_client_php.zip | PHP Client Library for VinAudit APIs |
Retrieve raw data for a VIN Report
To query whether data for a VIN 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. 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 | true |
| error |
One of: expired report missing_report or blank if no error |
expired report |
| error_message |
One of: Report not initialized. Please request a new one. Report expired. Please request a new one. Failed to load data for: [output section name]. Please retry! Failed to load data for: attributes, accidents. Please retry! or blank if no error |
Report expired. Please request a new one. |
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."}
Available Source Code Resources
| FILE NAME | Description | |
|---|---|---|
| vinaudit_client_php.zip | PHP Client Library for VinAudit API’s |
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
