Documentation

Welcome to Vehicle Databases API's Documentation

Auction

GETRate LimitedJSON Response

Overview

Auction API comprises of information of instance of a vehicle being put up for sale through a vehicle auction in North America. The data includes the specifications of the vehicle at the time of the auction, along with all the related images for the listing.

COVERAGE

Classic and modern vehicles including cars, trucks, SUVs, vans, and motorcycles.

SUPPORT

Works 17 digit VINs and classic (5-14 digit VINs) based on US and Canada region.

HTTP Request

Endpoint

GET https://api.vehicledatabases.com/auction/{vin}

Example — Python / Requests

Target:

Client:

import requests
response = requests.get(
    "https://api.vehicledatabases.com/auction/{vin}",
    headers={"x-authkey": "YOUR_API_KEY"}
)
print(response.json())

GET Parameters

Parameter	Required	Description
vin	✓	Vehicle VIN number

JSON Response

Data covered in the API includes vehicle's information including, The price for which the salvaged vehicle was sold in auction or current bid in $, Location and date of auction. Seller information, Visual explanation of the car condition when auctioned through 10+ auction images, Accident and damage records. Odometer readings at the time of auction and more.

Response Fields

Parameter	Description
status	"success" or "error"
data	An object containing all data available.

{
    "status": "success",
    "vin": "1FMCU0G93GUB08696",
    "data": [
      {
        "sale_index": "sold-1",
        "price": "$2,500",
        "sale status": "Sold",
        "vname": "2016 Ford Escape, SE",
        "lot-number": "0-26488292",
        "car-features": {
          "Has_Keys": "yes",
          "Runs_Drives": "no",
          "Engine_Starts": "yes"
        },
        "title-and-condition": {
          "Title Type": "Salvage",
          "Title Description": "N/A",
          "Primary Damage": "Front end",
          "Secondary Damage": "N/A",
          "VIN": "1FMCU0G93GUB08696",
          "Common": "N/A"
        },
        "technical-specs": {
          "Odometer": "98,042 mi (157,783 km)",
          "Estimated Repair Cost": "$10,676",
          "Avg. Estimated Retail Value": "N/A",
          "Damage Ratio": "N/A",
          "Estimated Winning Bid": "N/A",
          "Body Style": "SUV 4 DOOR",
          "Color": "N/A",
          "Engine Type": "2.0L",
          "Fuel Type": "N/A",
          "Cylinders": "4",
          "Transmission": "Automatic",
          "Drive": ""
        },
        "sale-date-location": {
          "Seller Type": "Progressive Casualty Insurance",
          "Auction Date": "01-21-2020",
          "Auction Type": "N/A",
          "Location": "Southern New Jersey (NJ)",
          "Buyer Country": "N/A"
        },
        "listing-history": {
          "2020-01-21": "Sold $2,500"
        },
        "year": "2016",
        "make": "FORD",
        "model": "ESCAPE",
        "images": [
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-0.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=ZOY6WvCgOaaCKkAAGi%2FGALYx8eU%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-1.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=s08t3EYJWoL5XtFOwwq5%2BwSWQXo%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-2.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=U2bhfIfomb1reXzISOupplWgVcU%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-3.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=%2BZLTaHU1RpCoWiaSQD7yR08%2BiUo%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-4.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=aJXASL%2FKH7%2Bq1XSnjOuWVtD%2F5kQ%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-5.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=kUGlxfqhOjIOooc9%2Fgri%2FydwU%2BE%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-6.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=PWrJQ%2BzOtkmapMhrHskcBTqomPc%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-7.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=gJ0rAQlB8hC69uUxJdZobhSC6rk%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-8.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=Z0FMMuujIgqv4iBAK4cbLuIlamc%3D",
          "https://vhr-dev.sfo3.cdn.digitaloceanspaces.com/Report/auction/1FMCU0G93GUB08696/01-21-2020/img-0-9.jpg?AWSAccessKeyId=OPBFNLV5HC3ST3HB6RTF&Expires=1715273423&Signature=716XFwVl%2BhUY7ZROTgN5FoRZ3VU%3D"
        ],
        "market-value": {},
        "vin": "1FMCU0G93GUB08696"
      }
    ]
  }

Error Responses

error

status

When an error occurs, the API returns an error status with a code and message.

Code	Description	Resolution
400	Record(s) were not found for this vehicle.	Verify the VIN is correct or try a different vehicle.
401	Access denied due to invalid subscription key.	Provide a valid API key for an active subscription.
422	Too many requests	Reduce request frequency to comply with rate limits.
404	API not found	Check the API endpoint URL.
500	Blank	Server error. Contact support if the issue persists.

< Advanced VIN Decode Basic VIN Decode >

Navigation