Vehicle Price API

A vehicle's current used values by VIN, nationally, in USD

Try it

Get a vehicle's current used values from its VIN: what a dealer would ask at retail, what it would sell for between private parties, and what it would bring at auction. Values are national and in US dollars.

Endpoint

GET https://api.auto.dev/price/{vin}

View in Browser

https://api.auto.dev/price/1FMCU0G60LUA05025

Parameters

PropTypeDefault
vin
string
-
ambiguity?
boolean
false

Example Request

curl -X GET "https://api.auto.dev/price/1FMCU0G60LUA05025" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Structure

PropTypeDefault
vehicle?
object
-
prices?
object | null
-
ambiguous?
boolean
-
yearAmbiguous?
boolean
-
years?
number[]
-
trims?
string[]
-
styles?
array
-

Price Fields

A value that is not known is absent, never 0.

PropTypeDefault
retailOptions?
number
-
privatePartyOptions?
number
-
retailBase?
number
-
privatePartyBase?
number
-
auctionBase?
number
-

Example Response

A 2020 Ford Escape, recorded 2026-11-12. Values change as the market does.

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

Error Responses

Errors come wrapped in an error object. Every response also carries the api and user blocks, omitted from the examples below.

Invalid VIN

A malformed VIN answers 400 with code INVALID_VIN_FORMAT:

{
  "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"
  }
}

No Value on File

A vehicle with no values on file answers 404 with code NO_DATA_FOUND ("No market value on file for this …"). A VIN no price can be found for answers 404 with code VIN_NOT_FOUND.

Values Unavailable

When the values cannot be read right now, the answer is 503 with code SOURCE_ERROR. Retry later.

Interactive API Reference

Try Vehicle Price API

Test this endpoint with your API key and explore live responses

Plan Availability

  • Free: ❌ Not available
  • Growth: ✅ Available
  • Scale: ✅ Available

See pricing for plan details and signup.

Was this API reference helpful?