Back To API Subscriber Page
VIEW DEMO
Auction History API
ClearVin auction data contains all instances of a vehicle going up for sale through a vehicle auction. Our auction data contains the vehicle specifications at the time of the auction and all associated images for the listing.
Authorization
You will need to use email and password to get the access token using this URL:
POST https://www.clearvin.com/rest/vendor/login
Request must be from a registered IP address.The payload should be:
{ "email" : “example@example.com”, "password": "11111111" }
Response
ELEMENT | DESCRIPTION | FORMAT |
---|---|---|
status | States whether the request was handled successfully, or ended with an error |
String error or ok
|
message |
Contains details about the result if status is error
|
String |
token | JSON web token. The token expires in 10 minutes | String |
If email and password are correct the token will be returned response with token as follows:
{ "status": "ok", "token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0" }
Report
After you receive this token you can use it to access reports using this URL:
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
To use this endpoint, you need to provide HTTP header with the supplied token as follows:
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Response
ELEMENT | ELEMENT | TYPE |
---|---|---|
status | States whether the request was handled successfully, or ended with an error | String error or ok |
message |
Contains details about the result if status is error
|
String |
Report id | Contains current report id | String |
Report vin | Requested vin | String |
Report report | Contains full information about the vehicle | JSON object |
You can also receive reports in html view by using URL like this:
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
And provide next HTTP headers:
Authorization: Bearer
I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html
Preview
You can get report preview using this URL:
GET https://www.clearvin.com/rest/vendor/preview?vin=5UXFA13544LU21050
To use this endpoint, you need to provide HTTP header with the supplied token as follows:
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Response
ELEMENT | ELEMENT | TYPE |
---|---|---|
status | States whether the request was handled successfully, or ended with an error | String error or ok |
message |
Contains details about the result if status is error
|
String |
VinSpec | Contains short vin specification | JSON object |
Recalls | Contains full recalls’ descriptions | JSON object |
PreviewImageURL | Car preview image URL | String |
ImagesAmount | Number of images in the full report | Number |
AuctionHistoryRecords | Number of auction records | Number |
Auth success
Requestcurl -X POST \ https://www.clearvin.com/rest/vendor/login \ -H 'Content-Type: application/json' \ -d '{ "email": "test@domain.com", "password": "yourpassword" } '
{ "status": "ok", "token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0" }
{ "status": "error", "message": "Wrong username or password" }
Report
Requestcurl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ - H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ - H 'Content-Type: application/json'
{ "status": "ok", "result": { "id": "3646F9E2", "vin": "WBAFR7C57CC811956", "report": { "auctions": [{ "announced_at_auction": "Jun 5, 2015", "make": "BMW", "model": "535I", "odometer": 26226, "odometer_status": "ACTUAL", "color": "BLACK", "engine": "3.0L L6 FI DOHC 24V F4", "drive": null, "acv": 37409, "repair_cost": null, "fuel": null, "cylinders": null, "own_doc": "CA SALVAGE CERTIFICATE", "primary_damage": "FRONT END", "secondary_damage": "LEFT SIDE", "location": "Anaheim", "sale_date": "2015-07-20", "sale_status": null, "images": ["https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891b27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891827294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891927294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891e27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891f27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891c27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891d27294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891227294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891327294a7c2c", "https://clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891b5b4b0e663b7b"], "condition": "WON'T START", "auctionId": "591778387", "vendor": "salvagebid.com", "title_state": "CA", "date": "Jul 20, 2015" }, { "announced_at_auction": "Aug 10, 2015", "make": "BMW", "model": "535I", "odometer": "26227", "odometer_status": "ACTUAL", "color": "BLACK", "engine": "3.0L 6L 6", "drive": "Rear-wheel drive", "acv": "31250.00", "repair_cost": "0.00", "fuel": "GAS", "cylinders": "6", "own_doc": "CA SALVAGE CERTIFICATE", "primary_damage": "PARTIAL REPAIR", "secondary_damage": "", "location": "CA - SAN BERNARDINO", "sale_date": "2015-09-10", "sale_status": "On Minimum Bid", "images": ["https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e6ca4931c0f33466d662f5e5252da7f23418118bc58cf287641eb574b2cac342cf355e4879cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e3da0c21b5e32156d662b550150da7f2e17dc18e756ce2d7642ec56487cf56270f759ead39cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e68f193185d3f426a6629515751da7f23488018e706932a761aba5d4c7afd3573fe59e8d79cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e6ef6931c0832433a662d02015fda7f71448918e704947e7646b9561977fa6524a40bedd59cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e63f4954e0d66183d66785f0407da7f2013de18bf51c1787614b65e4b2afe3473f655bf849cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e63a7951c5f37463a66795e5457da7f75448e18bf59c62b7612b70f4e2ef43577f659e58e9cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e62f4961f5336106a662c500455da7f75408018e605c02a761be9081e78f53270fe55ebd09cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e62a4c24c5930423e662956065eda7f7412dc18e70592247615eb5e4829f46123f75bb8d39cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e62a4c71c0d641739667d520356da7f2f44de18bc54c4257611b7561e79fe3373a45de8d59cb17678", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f452fd729300cb8a75524e68a1931c5a32176d6624025404da7f22158b18bf0694247610e95e182ca96626f35beed39cb17678"], "condition": "Run & Drive Verified", "auctionId": "29866715", "vendor": "autobidmaster.com", "title_state": "CA", "date": "Sep 10, 2015" }, { "announced_at_auction": "Dec 2, 2016", "make": "BMW", "model": "535I", "odometer": "0", "odometer_status": "NOT ACTUAL", "color": "BLACK", "engine": "3.0LL 6", "drive": "Rear-wheel drive", "acv": "0.00", "repair_cost": "0.00", "fuel": "GAS", "cylinders": "6", "own_doc": "CA SALVAGE CERTIFICATE", "primary_damage": "MECHANICAL", "secondary_damage": "", "location": "*NCS - PACIFIC REGION", "sale_date": "2017-02-20", "sale_status": "", "images": ["https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d48521535862f3c61b463516687f31525d5691662f158b03f357917d6c1bba0b487cf96571e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4872150046ea0971d4662453d2f31525c04c5667612dc56f305c2796f16e90b4d2af56823e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d3205a0338a2c1484663196d283152040396662e128a00f306c32e6d17bd5f1e7fff6827e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4837c07043aa2c51b4634126a7931525204926675128b00f306c7256c40bb0b4d2da83670e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d4215a5738a5971d4663443e2a3152065392662e468c03f351c02d3a12ee5e4e2caf3321e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d72605523fa19448463746342f31525c50c2662e178d50f359c0793812be5c452aac3126e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d48374500363a292194637443e2d31520407cf6676178f54f352932e3d13b65c1b2bf8622de8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d67d07566aa1c74f466243697931525453ce6676418f0cf301ce2e6c46bf084b7da86822e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d72551533ea2914f4665123f2d3152075e96662f108f02f356c7256b45eb574b2af56774e8278df1", "https://clearvin.com/images/auctions/a540c388ce3ad8a480d96910b6b1a0897c70ad64cbd50693020bbaa613066fcd62a33590f79d9d2dc3cba3f44cf57a9604d4d471565669a390494634196f783152510395662e12dc50f357c17e3a17be5d192cab3676e8278df1"], "condition": null, "auctionId": "42699816", "vendor": "autobidmaster.com", "title_state": "CA", "date": "Feb 20, 2017" }] } } }
Preview
Requestcurl - X GET\ 'https://www.clearvin.com/rest/vendor/preview?vin=WAUFFAFL7AN042408'\ - H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ - H 'Content-Type: application/json'
{ "status": "ok", "result": { "previewImageURL": "https://www.clearvin.com/images/auctions/a540c388ce3ad8a490996a06aaecb69e7b2ae33a889b1dc3572581932c2a32d86ee06a82fd96c47094d4a0ed2b89178d04ce8174535269a6891b3f294a7c2c", "imagesAmount": 10, "auctionHistoryRecords": 1, "vinSpec": { "vin": "WBAFR7C57CC811956", "year": "2012 ", "madeIn": "GERMANY ", "model": "5-Series ", "trim": "535i ", "engine": "3.0L L6 DOHC 24V ", "make": "BMW " }, "recalls":[ { "Manufacturer": "BAYERISCHE MOTOREN WERKE", "NHTSACampaignNumber": "03V475000", "ReportReceivedDate": "Nov 14, 2003", "Component": "POWER TRAIN:DRIVELINE:DIFFERENTIAL UNIT", "Summary": "ON CERTAIN SPORT UTILITY VEHICLES, THE BOLTS THAT HOLD THE FRONT DIFFERENTIAL, THE RIGHT OUTPUT SHAFT HOUSING FLANGE AT THE ENGINE, AND THE RIGHT-HAND ENGINE SUPPORT MAY BE INSUFFICIENTLY TIGHTENED. \r\n", "Conequence": "WITH PROLONGED DRIVING, THESE BOLTS COULD BECOME LOOSE, CAUSE DAMAGE TO THE ENGINE AND TRANSMISSION HOUSINGS. THE RIGHT OUTPUT SHAFT COULD BECOME DISCONNECTED, AFFECTING THE ABILITY TO CONTROL THE VEHICLE, WHICH COULD RESULT IN A CRASH. \r\n", "Remedy": "DEALERS WILL INSPECT AND RETIGHTEN THE DRIVETRAIN FASTENERS. OWNER NOTIFICATION BEGAN NOVEMBER 28, 2003. OWNERS SHOULD CONTACT BMW AT 1-800-831-1117.\r\n", "Notes": "CUSTOMERS CAN ALSO CONTACT THE NATIONAL HIGHWAY TRAFFIC SAFETY ADMINISTRATION'S AUTO SAFETY HOTLINE AT 1-888-DASH-2-DOT (1-888-327-4236).\r\n", "ModelYear": "2004", "Make": "BMW", "Model": "X5" }, { "Manufacturer": "BAYERISCHE MOTOREN WERKE", "NHTSACampaignNumber": "04V344000", "ReportReceivedDate": "Jul 14, 2004", "Component": "POWER TRAIN:AUTOMATIC TRANSMISSION:CONTROL MODULE (TCM, PCM)", "Summary": "ON CERTAIN PASSENGER VEHICLES EQUIPPED WITH 8 AND 12 CYLINDER ENGINES, THE DIGITAL ENGINE MANAGEMENT CONTROL (EMC) UNITS WERE NOT PRODUCED ACCORDING TO SPECIFICATIONS. \r\n", "Conequence": "AS A RESULT, ENGINE STALLING WILL OCCUR AFTER A SHORT PERIOD OF OPERATION. THE VEHICLE MAY NOT BE ABLE TO RESTART. ALSO, A LOSS OF POWER STEERING AND, AFTER REPEATED ACTUATION OF THE BRAKE PEDAL, A LOSS OF BRAKE POWER ASSIST WILL OCCUR.\r\nTHESE CONDITIONS COULD RESULT IN A VEHICLE CRASH.\r\n", "Remedy": "DEALERS WILL INSTALL A NEW DIGITAL ENGINE MANAGEMENT CONTROL UNIT. THE RECALL BEGAN ON JULY 16, 2004. OWNERS SHOULD CONTACT BMW AT 1-800-831-1117.\r\n", "Notes": "CUSTOMERS CAN CONTACT THE NATIONAL HIGHWAY TRAFFIC SAFETY ADMINISTRATION'S AUTO SAFETY HOTLINE AT 1-888-DASH-2-DOT (1-888-327-4236).\r\n", "ModelYear": "2004", "Make": "BMW", "Model": "X5" }, { "Manufacturer": "BMW OF NORTH AMERICA, LLC", "NHTSACampaignNumber": "04V409000", "ReportReceivedDate": "Aug 18, 2004", "Component": "POWER TRAIN:CLUTCH ASSEMBLY:PEDAL/LINKAGE", "Summary": "ON CERTAIN PASSENGER VEHICLES WITH 3.0 L ENGINES AND MANUAL TRANSMISSIONS, IF THE VEHICLE IS IN FIRST GEAR, AND MOVING SLOWLY, WITH THE ACCELERATOR PEDAL HELD IN A CONSTANT POSITION OF LOW ENGINE SPEED AND WITH THE CLUTCH PEDAL HELD IN A PARTIALLY DEPRESSED POSITION, ENGINE SPEED MAY INCREASE. \r\n", "Conequence": "THE VEHICLE COULD ACCELERATE UNEXPECTEDLY, WHICH COULD RESULT IN A CRASH.\r\n", "Remedy": "DEALERS WILL REPROGRAM THE VEHICLE'S DIGITAL ENGINE MANAGEMENT CONTROL UNIT. THE RECALL BEGAN ON SEPTEMBER 8, 2004. OWNERS SHOULD CONTACT BMW AT 1-800-831-1117.\r\n\r\n", "Notes": "CUSTOMERS CAN ALSO CONTACT THE NATIONAL HIGHWAY TRAFFIC SAFETY ADMINISTRATION'S AUTO SAFETY HOTLINE AT 1-888-DASH-2-DOT (1-888-327-4236).\r\n ", "ModelYear": "2004", "Make": "BMW", "Model": "X5" }, { "Manufacturer": "BMW OF NORTH AMERICA, LLC", "NHTSACampaignNumber": "04V402000", "ReportReceivedDate": "Aug 13, 2004", "Component": "FUEL SYSTEM, GASOLINE:DELIVERY:FUEL PUMP", "Summary": "ON CERTAIN SPORT UTILITY VEHICLES, THE IN-TANK FUEL LINE MAY HAVE BEEN ATTACHED INCORRECTLY. \r\n\r\n", "Conequence": "ENGINE STALLING COULD OCCUR, EVEN THOUGH THE VEHICLE'S FUEL GAUGE INDICATES THAT FUEL IS PRESENT IN THE TANK. DEPENDING UPON TRAFFIC AND ROAD CONDITIONS, THIS COULD RESULT IN A CRASH.\r\n\r\n", "Remedy": "DEALERS WILL INSPECT THE IN-TANK SUCTION JET PUMP FUEL LINE AND IF NECESSARY, REATTACH ACCORDING TO SPECIFICATIONS. THIS RECALL BEGAN SEPTEMBER 9, 2004. OWNERS SHOULD CONTACT BMW AT 1-800-831-1117.\r\n", "Notes": "CUSTOMERS CAN ALSO CONTACT THE NATIONAL HIGHWAY TRAFFIC SAFETY ADMINISTRATION'S AUTO SAFETY HOTLINE AT 1-888-DASH-2-DOT (1-888-327-4236).", "ModelYear": "2004", "Make": "BMW", "Model": "X5" } ] } }