Get Vehicle Price

Current used-vehicle values for a VIN, nationally, in USD: the dealer retail and private-party values with the style's typical options, and the base style's retail, private-party and auction values. A VIN that matches several styles is not priced as one of them: prices is null and styles lists each candidate with its own values, unless ambiguity=true.

GET
/price/{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}$

Query Parameters

ambiguity?boolean

Whether to allow a best-guess answer for a VIN that matches several styles. By default (false) the answer does not guess: style is null, trim is null unless our sources settle it (specs is null on /specs), and trims and styles list the possibilities. true allows a single best-guess pick. Also accepted as the X-Ambiguity header.

Defaultfalse

Response Body

curl -X GET "https://api.auto.dev/price/string?ambiguity=false"

{
  "vehicle": {
    "vin": "1FMCU0G60LUA05025",
    "year": 2020,
    "make": "Ford",
    "model": "Escape"
  },
  "prices": {
    "retailOptions": 16380,
    "privatePartyOptions": 13502,
    "retailBase": 14475,
    "privatePartyBase": 11932,
    "auctionBase": 7839
  }
}

{
  "vin": "1FMCU0G60",
  "vinValid": false,
  "error": {
    "status": 400,
    "error": "VIN must be exactly 17 characters containing only letters and numbers (excluding I, O, Q)",
    "code": "INVALID_VIN_FORMAT",
    "path": "/price/1FMCU0G60",
    "requestId": "a5986becfb48f459"
  }
}

{
  "error": {
    "status": 404,
    "error": "VIN not supported",
    "code": "VIN_NOT_FOUND",
    "path": "/price/1T9P61527VP394134",
    "requestId": "a5986bf5db8a6fbc"
  }
}
{
  "error": {
    "status": 0,
    "error": "string",
    "code": "string",
    "path": "string",
    "requestId": "string",
    "reason": "not_yet_available",
    "retryable": true,
    "detectedMarket": {
      "country": "string",
      "region": "string"
    },
    "detectedClass": {
      "vehicleType": "string"
    }
  },
  "vin": "string",
  "vinValid": true
}