Auto.dev

Get Vehicle Listing by VIN

Get a single vehicle listing by VIN. Returns detailed vehicle information, dealership data, specifications, and market pricing for the specified vehicle.

GET
/listings/{vin}
AuthorizationBearer <token>

Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

In: header

Path Parameters

vinstring

17-character Vehicle Identification Number

Match^[A-HJ-NPR-Z0-9]{17}$

Response Body

curl -X GET "https://api.auto.dev/listings/string"

{
  "data": {
    "@id": "https://api.auto.dev/listings/10ARJYBS7RC154562",
    "vin": "10ARJYBS7RC154562",
    "location": [
      -77.0334,
      40.2476
    ],
    "online": true,
    "vehicle": {
      "vin": "10ARJYBS7RC154562",
      "squishVin": "10ARJYBSRC",
      "year": 2024,
      "make": "Jeep",
      "model": "Grand Cherokee",
      "trim": "4xe",
      "drivetrain": "4WD",
      "engine": "Plug-In Hybrid",
      "fuel": "Plug-In Hybrid",
      "transmission": "Automatic",
      "confidence": 0.005,
      "doors": 4,
      "seats": 5
    },
    "wholesaleListing": null,
    "retailListing": {
      "vdp": "http://details.vast.com/details/cars/...",
      "price": 0,
      "used": false,
      "cpo": false,
      "carfaxUrl": "https://www.carfax.com/VehicleHistory/p/Report.cfx?vin=10ARJYBS7RC154562&partner=FRD_2",
      "dealer": "Faulkner Dodge Ram Mechanicsburg New",
      "city": "Mechanicsburg",
      "state": "PA",
      "zip": "17050",
      "primaryImage": "https://retail.photos.vin/10ARJYBS7RC154562-1.jpg",
      "photoCount": 1
    },
    "history": null
  }
}

{
  "error": {
    "status": 400,
    "error": "VIN must be exactly 17 characters containing only letters and numbers (excluding I, O, Q)",
    "code": "INVALID_VIN_FORMAT",
    "path": "/listings/137ZA90311E1908",
    "requestId": "979dc9ef5ff3c3a9"
  }
}

{
  "error": {
    "status": 404,
    "error": "Resource \"WP0AF2A99KS165242\" not found",
    "code": "RESOURCE_NOT_FOUND",
    "path": "/listings/WP0AF2A99KS165242",
    "requestId": "966716ac29ed8147"
  }
}