Documentation
Welcome to Vehicle Databases API's Documentation
Market Value
Overview
Get access to trade-in, private party, and retail values for any vehicle based on state and mileage with our vehicle market value API. Vehicle Databases API service allows you instant access to accurate vehicle market value information. We provide estimates of market value for used and new cars by year, make, model and trim based on market trends analysis for used cars and dealer sales all across North America. We analyze vehicle market value data based on millions of vehicle sales and transactions. Our database is updated frequently to give accurate market value details.
COVERAGE
US Region Vehicles.
SUPPORT
Works for 17 characters VINs
HTTP Request
Endpoint
GET https://api.vehicledatabases.com/market-value/v2/{vin}Example — Python / Requests
import requests
response = requests.get(
"https://api.vehicledatabases.com/market-value/v2/{vin}",
headers={"x-authkey": "YOUR_API_KEY"}
)
print(response.json())GET Parameters
| Parameter | Required | Description |
|---|---|---|
| vin | ✓ | 17 characters VIN number |
| mileage (query parameter) | Optional | Vehicle Mileage in miles |
| state (query parameter) | Optional | US State |
JSON Response
The response is a JSON of all the information associated with a VIN number. Each vin number has the following elements:
Response Fields
| Parameter | Description |
|---|---|
| status | "success" or "error" |
| data | An object containing all data available. |
Example Response
{
"status": "success",
"data": {
"intro": {
"vin": "WBAPH7G50BNM56522"
},
"basic": {
"make": "BMW",
"model": "328",
"year": "2011",
"trim": "i 4dr Rear-wheel Drive Sedan Manual",
"state": "NY",
"mileage": "12,000"
},
"market_value": {
"market_value_data": [
{
"trim": "i 4dr Rear-wheel Drive Sedan Manual",
"market value": [
{
"Condition": "Outstanding",
"Trade-In": "$6,829",
"Private Party": "$12,153",
"Dealer Retail": "$15,200"
},
{
"Condition": "Clean",
"Trade-In": "$6,483",
"Private Party": "$11,473",
"Dealer Retail": "$14,273"
},
{
"Condition": "Average",
"Trade-In": "$5,906",
"Private Party": "$10,341",
"Dealer Retail": "$12,727"
},
{
"Condition": "Rough",
"Trade-In": "$5,157",
"Private Party": "$8,869",
"Dealer Retail": "$10,719"
}
]
}
]
}
}
}Error Responses
When an error occurs, the API returns an error status with a code and message.
| Code | Description | Resolution |
|---|---|---|
| 400 | Record(s) were not found for this vehicle. | Verify the VIN or YMM is correct. |
| 401 | Invalid API Key | Check your API key for correctness and ensure it is properly formatted. |
| 403 | Rate limit exceeded | You have exceeded the number of allowed requests in a given time period. Please wait and try again. |
| 422 | Validation error | One or more parameters are invalid. Check the request parameters for correctness. |
| 500 | Internal server error | An unexpected error occurred on the server. Please try again later or contact support. |