+1 (844) 268 – 5991
6807 NE 79th ct Ste B Portland OR 97218
Menu
User
Back To API Subscriber Page
Affiliate

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.

VIEW DEMO

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 DESCRIPTION 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 DESCRIPTION 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
PreviewImageURL Car preview image URL String
ImagesAmount Number of images in the full report Number
AuctionHistoryRecords Number of auction records Number

Auth success

Request 
curl -X POST \
    https://www.clearvin.com/rest/vendor/login \
    -H 'Content-Type: application/json' \
    -d '{
        "email": "test@domain.com",
        "password": "yourpassword"
} '
Response success 
{
    "status": "ok",
    "token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}
Response error 
{
    "status": "error",
    "message": "Wrong username or password"
}


Report

Request 
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ -
    H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
    H 'Content-Type: application/json'
Response 
{
    "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

Request 
curl - X GET\ 'https://www.clearvin.com/rest/vendor/preview?vin=WAUFFAFL7AN042408'\ -
    H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
    H 'Content-Type: application/json'
Response 
{
    "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 "
        }
    }
}