Skip to content
Live catalog

VIN reports

Vehicle history reports through one API.

Check a VIN across 11 report types for free, then get the report you need as JSON, HTML or PDF. Everything on this page runs against the live API with your own key.

Open the playground ↓Product page
From a VIN to the filesILLUSTRATIONVehicle history reports
POST /checksPOST /reports

Three calls from a VIN to the files

  1. 1Free

    Check the VIN

    Every report type answers whether it has records, with a short preview and its formats and languages.

    POST /checks
  2. 3Free

    Open the files

    Links to JSON, HTML and PDF. Long reports answer 202: follow status_url until the status is final.

    GET /requests/{id}

Playground

Pick a sample VIN or type any VIN, choose a report and open the files. Sample VINs are free; your own VINs are checked with your key.

Connect your API key The playground uses the same key as the rest of the documentation. It stays in this browser.

Apply saves this key for the documentation and demo catalog.

Choose a VIN

Sample VINs are free. Any other VIN is checked with your key.

Choose a report

Found 9 / 11

No record: Avtocod · Korean Insurance History

Get the files

Formats
Report language
JSONHTMLPDF

Charged only when the report is ready, one charge for all formats. Sample VINs are free.

Requestsx-api-key: YOUR_API_KEY
Sample answer
  1. {
  2. "request_id": "00000000-0000-4000-8000-000000000001",
  3. "vin": "7FARW2H56JE022576",
  4. "status": "completed",
  5. "sources": [
  6. {
  7. "id": 11,
  8. "name": "Korean Insurance History",
  9. "status": "not_found",
  10. "available_formats": [],
  11. "available_languages": [
  12. "en",
  13. "ru"
  14. ],
  15. "preview": {
  16. "has_data": false
  17. }
  18. },
  19. {
  20. "id": 10,
  21. "name": "Avtocod",
  22. "status": "not_found",
  23. "available_formats": [],
  24. "available_languages": [
  25. "ru"
  26. ],
  27. "preview": {
  28. "vehicle": []
  29. }
  30. },
  31. {
  32. "id": 1,
  33. "name": "USA Insurance Auctions & Korea History",
  34. "available_formats": [
  35. "json",
  36. "html",
  37. "pdf"
  38. ],
  39. "available_languages": [
  40. "en",
  41. "ru"
  42. ],
  43. "preview": {
  44. "has_data": true,
  45. "thumbnail_url": "https://v-h-r.b-cdn.net/vhr/media/017760110fc426b7d79008da1c0427467829a05cd60dcfdb3ca4a5a9a0b39f42.webp",
  46. "records_count": 3
  47. }
  48. },
  49. {
  50. "id": 2,
  51. "name": "Vehicle Archive Alpha",
  52. "available_formats": [
  53. "json",
  54. "html",
  55. "pdf"
  56. ],
  57. "available_languages": [
  58. "en",
  59. "ru"
  60. ],
  61. "preview": {
  62. "exists": true,
  63. "records_count": 3,
  64. "equipment_options_count": 8
  65. }
  66. },
  67. {
  68. "id": 3,
  69. "name": "Vehicle Archive Beta",
  70. "available_formats": [
  71. "json",
  72. "html",
  73. "pdf"
  74. ],
  75. "available_languages": [
  76. "en",
  77. "ru"
  78. ],
  79. "preview": {
  80. "exists": true,
  81. "records_count": 2
  82. }
  83. },
  84. {
  85. "id": 4,
  86. "name": "Vehicle Inspections",
  87. "available_formats": [
  88. "json",
  89. "html",
  90. "pdf"
  91. ],
  92. "available_languages": [
  93. "en",
  94. "ru"
  95. ],
  96. "preview": {
  97. "exists": true,
  98. "records_count": 1
  99. }
  100. },
  101. {
  102. "id": 5,
  103. "name": "Vehicle History",
  104. "available_formats": [
  105. "json",
  106. "html",
  107. "pdf"
  108. ],
  109. "available_languages": [
  110. "en",
  111. "ru"
  112. ],
  113. "preview": {
  114. "exists": true,
  115. "records_count": 1
  116. }
  117. },
  118. {
  119. "id": 6,
  120. "name": "US Dealer Listings",
  121. "available_formats": [
  122. "json",
  123. "html",
  124. "pdf"
  125. ],
  126. "available_languages": [
  127. "en"
  128. ],
  129. "preview": {
  130. "exists": true,
  131. "records_count": 1,
  132. "vehicle": {
  133. "year": 2018,
  134. "make": "Honda",
  135. "model": "CR-V",
  136. "trim": "EX AWD"
  137. },
  138. "photos_count": 2
  139. }
  140. },
  141. {
  142. "id": 7,
  143. "name": "Autoteka",
  144. "available_formats": [
  145. "json",
  146. "html",
  147. "pdf"
  148. ],
  149. "available_languages": [
  150. "ru"
  151. ],
  152. "preview": {
  153. "has_data": true,
  154. "vehicle": {
  155. "brand": "Honda",
  156. "model": "CR-V EX AWD",
  157. "generation": "B8",
  158. "year": 2018,
  159. "engineType": "дизель",
  160. "engineCapacity": "2.0",
  161. "transmission": "робот",
  162. "driveType": "передний привод",
  163. "body": "универсал"
  164. },
  165. "thumbnail_url": "https://v-h-r.b-cdn.net/vhr/media/017760110fc426b7d79008da1c0427467829a05cd60dcfdb3ca4a5a9a0b39f42.webp"
  166. }
  167. },
  168. {
  169. "id": 8,
  170. "name": "Belarus Listing History",
  171. "available_formats": [
  172. "json",
  173. "html",
  174. "pdf"
  175. ],
  176. "available_languages": [
  177. "ru"
  178. ],
  179. "preview": {
  180. "has_data": true,
  181. "vehicle": {
  182. "brand": "Honda",
  183. "model": "CR-V EX AWD",
  184. "generation": "B8",
  185. "year": 2018,
  186. "engineType": "дизель",
  187. "engineCapacity": "2.0",
  188. "transmission": "робот",
  189. "driveType": "передний привод",
  190. "body": "универсал"
  191. },
  192. "thumbnail_url": "https://v-h-r.b-cdn.net/vhr/media/017760110fc426b7d79008da1c0427467829a05cd60dcfdb3ca4a5a9a0b39f42.webp",
  193. "advertsCount": 2
  194. }
  195. },
  196. {
  197. "id": 9,
  198. "name": "Belarus Official History",
  199. "available_formats": [
  200. "json",
  201. "html",
  202. "pdf"
  203. ],
  204. "available_languages": [
  205. "ru"
  206. ],
  207. "preview": {
  208. "has_data": true,
  209. "vehicle": {
  210. "brand": "Honda",
  211. "model": "CR-V EX AWD",
  212. "generation": "B8",
  213. "year": 2018,
  214. "engineType": "дизель",
  215. "engineCapacity": "2.0",
  216. "transmission": "робот",
  217. "driveType": "передний привод",
  218. "body": "универсал"
  219. },
  220. "thumbnail_url": "https://v-h-r.b-cdn.net/vhr/media/017760110fc426b7d79008da1c0427467829a05cd60dcfdb3ca4a5a9a0b39f42.webp",
  221. "advertsCount": 2
  222. }
  223. }
  224. ],
  225. "status_url": "https://auctionsapi.com/api/vhr/requests/00000000-0000-4000-8000-000000000001"
  226. }

Sample VINs

They answer at once, cost nothing and are not kept in your report history. Click a VIN to copy it.

Report types

Each source is a separate report with its own formats and languages. Your key may see fewer of them.

ReportWhat it coversFormatsLanguages
USA Insurance Auctions & Korea History#1 · USA · South KoreaUS insurance auctions and Korean listings · Vehicle photos and specifications · Prices, mileage and recorded damageJSONHTMLPDFENRU
Vehicle Archive Alpha#2 · Global coveragePast listings and price changes · Photographs and mileage · Factory equipment and optionsJSONHTMLPDFENRU
Vehicle Archive Beta#3 · Europe · USA · South KoreaAuction and marketplace listings · Photographs and sale prices · Vehicle details and listing historyJSONHTMLPDFENRU
Vehicle Inspections#4 · Multiple marketsInspection conclusions and damage · Checked components and diagnostics · Photos and supporting documentsJSONHTMLPDFENRU
Vehicle History#5 · Multiple marketsRecorded checks and vehicle events · Mileage and ownership information · Insurance events and history documentsJSONHTMLPDFENRU
US Dealer Listings#6 · USAUS dealership listing history · Prices, mileage and vehicle details · Photos, features and history summariesJSONHTMLPDFEN
Autoteka#7 · RussiaOwners, mileage and accident history · Restrictions, pledges and insurance · Service records and past listingsJSONHTMLPDFRU
Belarus Listing History#8 · BelarusPast vehicle advertisements · Photos and vehicle characteristics · Recorded prices and listing datesJSONHTMLPDFRU
Belarus Official History#9 · BelarusRegistration and technical inspections · Accidents, insurance and import records · Available vehicle advertisementsJSONHTMLPDFRU
Avtocod#10 · RussiaOwners, registration and mileage · Accidents, insurance and restrictions · Pledges, fines and available listingsJSONHTMLPDFRU
Korean Insurance History#11 · South KoreaInsurance claims and repair costs · Ownership, mileage and special use · Equipment, export declarations and recallsJSONHTMLPDFENRU

Seven endpoints

Base URLhttps://auctionsapi.com/api/vhr

Checks, statuses and files are free. Only ordering a report is billed, once, when its files are ready.

GETList report types/sourcesFreePOSTCheck a VIN/checksFreePOSTOrder a report/reportsGETFollow a request/requests/{id}FreeGETList your reports/reportsFreeGETGet a report/reports/{id}FreePOSTRetry failed files/reports/{id}/retryFree

Go further

Statuses, errors and webhooksEvery status, every error and how to verify a webhook.Prompt for AI agentsOne prompt that teaches an AI agent the whole VHR API.
© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.