API reference / Lookup

Get a vehicle by VIN

GET/search-vin/{vin}

Retrieve one vehicle and its available Copart and IAAI listings by VIN. Searches active and archived listings.

The lookup is case-insensitive and matches the complete stored VIN. It does not do prefix or wildcard searches.
Returns one vehicle in data with its lots. Set prices_history=1 to include price history for each lot.
Returns HTTP 404 when the VIN is not found or has no listings available to your account, and HTTP 423 for a restricted record.

Change the values below
The request on the right updatesThe request above updates
Run it live with your key

Path parameters

vinstring · required

VIN to look up. Matches the complete stored value, case-insensitively. No wildcard or prefix search.

Query parameters 1

prices_historyinteger · 0–1

Set 1 to include the prices history array for each lot. Omit or use 0 for the standard response.

GET /search-vin/{vin}

curl --get 'https://auctionsapi.com/api/search-vin/YV1MC67278J058366' \  --header 'x-api-key: YOUR_API_KEY'

200

example data

{  "data": {    "id": 16070300,    "year": 2023,    "title": "2023 BMW M8",    "vin": "WBSAE0C06PCL70372",    "manufacturer": {      "id": 16,      "name": "BMW"    },    "model": {      "id": 3038,      "name": "M8",      "manufacturer_id": 16    },    "generation": {      "id": 900001,      "name": "I (F92) LCI",      "manufacturer_id": 16,      "model_id": 3038    },    "body_type": {      "name": "coupe",      "id": 3    },    "color": {      "name": "green",      "id": 4    },    "engine": {      "id": 39,      "name": "4.4l 8"    },    "transmission": {      "name": "automatic",      "id": 1    },    "drive_wheel": {      "name": "all",      "id": 3    },    "vehicle_type": {      "name": "automobile",      "id": 1    },    "fuel": {      "name": "gasoline",      "id": 4    },    "cylinders": 8,    "lots": [      {        "id": 16447827,        "lot": "94166665",        "domain": {          "name": "copart_com",          "id": 3        },        "external_id": null,        "odometer": {          "km": 28218,          "mi": 17534,          "status": {            "name": "actual",            "id": 1          }        },        "estimate_repair_price": null,        "pre_accident_price": 88591,        "clean_wholesale_price": 97575,        "actual_cash_value": null,        "sale_date": "2026-03-25T15:55:05.000000Z",        "sale_date_updated_at": "2026-03-26T15:56:32.000000Z",        "bid": 56500,        "bid_updated_at": "2026-03-25T14:01:44.000000Z",        "buy_now": 0,        "buy_now_updated_at": "2026-03-01T23:14:06.000000Z",        "final_bid": 56500,        "final_bid_updated_at": "2026-03-15T03:12:52.000000Z",        "status": {          "name": "sold",          "id": 6        },        "seller": null,        "seller_type": null,        "title": {          "id": 4235,          "code": null,          "name": "Ct - Clean Title"        },        "detailed_title": {          "id": 1582,          "code": null,          "name": "Mi - Certificate Of Title"        },        "note": null,        "damage": {          "main": {            "id": 37,            "name": "Side"          },          "second": {            "id": 3,            "name": "Front End"          }        },        "keys_available": true,        "airbags": null,        "condition": {          "name": "run_and_drives",          "id": 0        },        "grade_iaai": null,        "images": {          "id": 19358054,          "small": [            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_thb.jpg",            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_thb.jpg"          ],          "normal": [            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_hrs.jpg",            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_hrs.jpg"          ],          "big": [            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/b1f12fe1dcf2485190eb28e2f104d11c_hrs.jpg",            "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/89c8fb28463844338e402c0b27b35259_hrs.jpg"          ],          "exterior": null,          "interior": null,          "video": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/1225/986c53a65f76451ab653fc6492983720_O.mp4",          "video_youtube_id": null,          "external_panorama_url": null,          "downloaded": [            "https://cars2.import-motor.com/copart/bmw/m8/2023/94166665/WBSAE0C06PCL70372-1.webp",            "https://cars2.import-motor.com/copart/bmw/m8/2023/94166665/WBSAE0C06PCL70372-2.webp"          ]        },        "location": {          "country": {            "iso": "us",            "name": "USA"          },          "state": {            "id": 82,            "code": "mi",            "name": "michigan"          },          "city": {            "id": 75,            "name": "davison"          },          "location": {            "id": 88,            "name": "mi - flint"          },          "latitude": 43.07812,          "longitude": -83.51813,          "postal_code": "48423 8502",          "is_offsite": null,          "raw": "mi - flint",          "offsite": null        },        "tags": [          "CERT-D",          "IV"        ],        "line": "A/92",        "selling_branch": {          "name": "mi - flint",          "link": null,          "number": null,          "id": 540618,          "domain_id": 3        },        "created_at": "2025-12-01T16:11:02.000000Z",        "updated_at": "2026-03-26T18:07:05.000000Z",        "details": null,        "is_timed_auction": false,        "seller_reserve": {          "price": 55000,          "updated_at": "2026-03-24T10:30:00.000000Z"        },        "auction_type": {          "name": "pure_sale",          "id": 1        },        "archived": true,        "archived_at": "2026-03-26T18:01:13.000000Z",        "prices": [          {            "id": 9746422,            "lot_id": 16447827,            "bid": 51000,            "final_bid_updated_at": "2026-03-13T18:20:35.000000Z",            "buy_now_price": null,            "sale_date": "2026-03-11T14:00:00.000000Z",            "status": {              "name": "not_sold",              "id": 8            }          }        ]      }    ]  }}