Authentication
Send x-api-key on every request. Source ids and formats come from your own catalog and VIN check; access and prices are applied by the API.
Check a VIN across 11 report types for free, see which ones have records, then get the full report as JSON for your product, a ready HTML page or a PDF for your customer.
Three steps with the real API: free checks, one report, then JSON, HTML and PDF files to open. Sample VINs are free.
Sample VINs are free. Any other VIN is checked with your key.
No record: Avtocod · Korean Insurance History
Charged only when the report is ready, one charge for all formats. Sample VINs are free.
From listing photos and equipment to inspections and insurance records. Each report covers a different part of a vehicle's history.
US insurance auctions and Korean listings · Vehicle photos and specifications · Prices, mileage and recorded damage
Past listings and price changes · Photographs and mileage · Factory equipment and options
Auction and marketplace listings · Photographs and sale prices · Vehicle details and listing history
Inspection conclusions and damage · Checked components and diagnostics · Photos and supporting documents
Recorded checks and vehicle events · Mileage and ownership information · Insurance events and history documents
US dealership listing history · Prices, mileage and vehicle details · Photos, features and history summaries
Owners, mileage and accident history · Restrictions, pledges and insurance · Service records and past listings
Past vehicle advertisements · Photos and vehicle characteristics · Recorded prices and listing dates
Registration and technical inspections · Accidents, insurance and import records · Available vehicle advertisements
Owners, registration and mileage · Accidents, insurance and restrictions · Pledges, fines and available listings
Insurance claims and repair costs · Ownership, mileage and special use · Equipment, export declarations and recalls
Need another report type? Tell us the country and the data you need, and we will tell you what we can add.
Ask usThe report lab uses the same endpoints as your integration. Requests use your key; code examples keep it hidden.
Send x-api-key on every request. Source ids and formats come from your own catalog and VIN check; access and prices are applied by the API.
POST /checks returns price, available_formats and a preview for every source. POST /reports takes one source_id, one language and one or more formats, for one price per report. If availability_confirmed is false, read availability_notice first.
JSON, HTML and PDF come as links on our CDN; some sources keep photos or a ready HTML page at their original address. Treat every report link as an access key.
HTTP waits up to 10 seconds. HTTP 202 means the work goes on: poll status_url every 1 to 2 seconds until the status is final. Never repeat a pending purchase.
A source error is not the same as no data. A report is charged only when every selected file is ready. If the files fail, POST /reports/{id}/retry reuses the saved data, with no second charge.
For real VINs add a public HTTPS webhook_url and a webhook_secret (16 to 256 characters). The API answers 202 and posts the result when it is ready, signed in X-VHR-Signature with X-VHR-Timestamp.
https://auctionsapi.com/api/vhr/sourcesList report types/checksCheck a VIN/reportsOrder a report/requests/{id}Follow a request/reportsList your reports/reports/{id}Get a report/reports/{id}/retryRetry failed filesSample VINs answer at once, cost nothing and are not kept in your report history. Full documentation →
The same data in three formats, in the language you ask for.
JSONSections and fields for your own pages and checks.
HTMLA finished report page you can open or embed.
PDFA file to send to your customer.
LanguagesEnglish or Russian, as each report type allows.
WebhooksA signed callback when the report is ready.
PhotosPhotos and documents kept with the report.
One API that checks a VIN across 11 vehicle history report types and returns the report you choose as JSON, an HTML page or a PDF.
Yes. The check tells you which sources have records for the VIN and shows a short preview. A report is charged only when it is made.
The check says so and the source cannot be ordered for that VIN, so you never pay for an empty report.
Most report types come as JSON, HTML and PDF from the same data; Avtocod comes as HTML and PDF. Each report type lists its languages: English, Russian or both.
Yes. The sample VINs in the report lab return full sample reports at no cost, here and through the API with the free demo key.
Write to us on Telegram or leave your contact below. We reply in writing with a demo key and the details of paid access.
Just leave a contact. We write back with the details and the price.