Vehicle History API

A unique report ID for this report request

The vehicle identification number

The account username

The account password*

Your account’s API key

Output format (json, xml or pdf)

Set to (USA or CAN); requires format=pdf

Set to test for development

A javascript callback method name; requires format=json

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

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

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

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)

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

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

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

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

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

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

• 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