Vehicle Price API
A vehicle's current used values by VIN, nationally, in USD
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/1FMCU0G60LUA05025Parameters
| Prop | Type | Default |
|---|---|---|
vin | string | - |
ambiguity? | boolean | false |
Example Request
curl -X GET "https://api.auto.dev/price/1FMCU0G60LUA05025" \
-H "Authorization: Bearer YOUR_API_KEY"Response Structure
| Prop | Type | Default |
|---|---|---|
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.
| Prop | Type | Default |
|---|---|---|
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?