Vehicle History API

The vehicle identification number

Your account’s API key

The account username

The account password

Output format (json or xml)

Set to 1 if attributes are not needed

Set to test for development (test VINs only)

A JavaScript callback method name

The report/request ID generated for this VIN lookup. Store this ID and use it when calling /v2/pullreport or /v2/report for the same report.

The vehicle identification number

A map of attributes about the VIN, including make, model, style, engine, made_in, and type.

Shows whether request succeeded and the VIN was decoded (base attributes returned). Does not guarantee a full report or NMVTIS availability.

One of:
1: Success, VIN decoded
0: Failed, decode/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

• (blank): if no error

A unique report/request ID for this Vehicle History Report. Use the same id with the same VIN when retrieving the same report within the 90-day retention period.

The vehicle identification number

The account username

The account password

Your account’s API key

Output format (json, xml or pdf)

Set to test for development

Set to USA or CAN; requires format=pdf

Set to 0 to produce unbranded PDF; requires format=pdf

Set to language code (en, es) for translated PDF; requires format=pdf

A JavaScript callback method name; requires format=json

The unique report identifier

The vehicle identification number

The date and time the report was pulled

A dynamic map of available vehicle attributes

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

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

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 U.S. 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)

• 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).

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 the primary damage associated with the vehicle (ex. rear end)

• secondary_damage: Description of the secondary damage associated with the 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)

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 occurred (if available)

• crash_severity: The severity of the accident as reported by source (if available)

• posted_speed: The posted speed limit where the accident occurred (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 that the vehicle 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).

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

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

A list of Canadian registration records with the format:

• jurisdiction: The province where 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

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 system affected by the recall

• notification_type: The type of notification

• manufacturer_recall_number: The recall number assigned by the manufacturer

• units_affected: The number of units affected

• 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 additional recall information

• website: Where to visit for additional recall information

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

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

Whether the report has been generated

One of:

• 1: Report was successfully generated

• 0: An error occurred while generating the report

One of:

• invalid_vin: Not a valid 17-digit VIN

• failed_request: Authorization process failed. Please try again later!

• unauthorized_request: Invalid API Key/Username/Password

• incomplete_report: NMVTIS database unavailable. Please retry later!

• expired_report: Report expired. Please request a new one

• missing_report: Report not initialized. Please request a new one

• (blank): if no error

The report ID

Your VinAudit API key

Response format (JSON, PDF, or XML)

Set to USA or CAN; requires format=pdf

Set to 0 to produce unbranded PDF; requires format=pdf

Set to language code (en, es) for translated PDF; requires format=pdf

Set to “1” if attributes are not needed

Set to “test” for development

JavaScript callback method

The report identifier

The vehicle identification number

A dynamic map of available vehicle attributes

A 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.

A 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 name

• disposition: The vehicle’s reported disposition

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

A list of Canadian registration records with the format:

• jurisdiction: The province where 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

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 system affected by the recall

• notification_type: The type of notification

• manufacturer_recall_number: The recall number assigned by the manufacturer

• units_affected: The number of units affected

• 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 additional recall information

• website: Where to visit for additional recall information

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

Whether the report has been generated

One of:

• true: Report was successfully generated

• false: An error occurred while generating the report

One of:

• expired_report: Report expired. Please request a new one

• missing_report: Report not initialized. Please request a new one.

• (blank): if no error