Vehicle Valuation
Get current market valuation for a vehicle by make, model, year, and country
Endpoint
GET https://api.carapi.dev/v1/vehicle-valuationParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| make | string | Required | Vehicle manufacturer (e.g., "bmw", "toyota", "volkswagen") |
| model | string | Required | Vehicle model (e.g., "x6", "camry", "golf") |
| year | integer | Required | Model year (e.g., 2019, 2020, 2021) |
| token | string | Required | API authentication token |
| country | string | Required | ISO 3166-1 alpha-2 country code for regional pricing (see supported countries below) |
| fuel | string | Optional | Fuel type filter (case-insensitive). One of: petrol, diesel, electric, hybrid, lpg, cng, hydrogen |
| kw | integer | Optional | Engine power in kW (0 — 2000). Narrows the valuation to a specific drivetrain variant. |
| mileage | integer | Optional | Current vehicle mileage in km (0 — 1,000,000). Refines the valuation for the supplied make/model/year/country. |
Supported Makes
Acura, Alfa Romeo, Audi, BMW, Cadillac, Chevrolet, Citroën, Cupra, Dacia, Dodge, Ferrari, Fiat, Ford, GMC, Honda, Hyundai, Jaguar, Jeep, Kia, Land Rover, Lexus, Mazda, Mercedes-Benz, MG, MINI, Mitsubishi, Nissan, Opel, Peugeot, Porsche, Ram, Renault, SEAT, Škoda, Subaru, Suzuki, Tesla, Toyota, Volvo, VW
40 makes supported with 500+ models. Try the API Playground for the full searchable list.
Supported Fuel Types
Pass the fuel parameter to narrow the valuation to a specific drivetrain variant. Values are case-insensitive.
Supported Countries
The following 24 countries are supported for regional vehicle valuation pricing:
Request Examples
cURL — basic
curl -X GET \
"https://api.carapi.dev/v1/vehicle-valuation?make=bmw&model=x6&year=2019&country=CZ&token=YOUR_API_KEY"cURL — narrow by fuel and power band
# Narrow to a specific drivetrain variant and supply current mileage
curl -X GET \
"https://api.carapi.dev/v1/vehicle-valuation?make=bmw&model=x3&year=2018&country=SK&fuel=diesel&kw=110&mileage=80000&token=YOUR_API_KEY"JavaScript
// Using fetch API
const params = new URLSearchParams({
make: 'bmw',
model: 'x6',
year: '2019',
country: 'CZ',
// Optional drivetrain filters
fuel: 'diesel',
kw: '110',
mileage: '80000',
token: 'YOUR_API_KEY'
});
const response = await fetch(`https://api.carapi.dev/v1/vehicle-valuation?${params}`, {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);Python
import requests
url = "https://api.carapi.dev/v1/vehicle-valuation"
params = {
"make": "bmw",
"model": "x6",
"year": 2019,
"country": "CZ",
# Optional drivetrain filters
"fuel": "diesel",
"kw": 110,
"mileage": 80000,
"token": "YOUR_API_KEY"
}
response = requests.get(url, params=params)
data = response.json()
print(data)Response Examples
Success Response (200) — basic
{
"make": "bmw",
"model": "x6",
"year": 2019,
"valuationPrice": 45393,
"currency": "EUR",
"country": "CZ"
}Success Response (200) — with fuel/kW filters
When you pass fuel, kw, or mileage, the response echoes the applied filters back.
{
"make": "bmw",
"model": "x3",
"year": 2018,
"valuationPrice": 24500,
"currency": "EUR",
"country": "SK",
"fuel": "diesel",
"kw": 110,
"mileage": 80000
}Error Response (404)
{
"error": "Vehicle valuation not found for the specified make, model, and year"
}Response Fields
| Field | Type | Description |
|---|---|---|
| make | string | Vehicle manufacturer (lowercase) |
| model | string | Vehicle model (lowercase) |
| year | number | Model year |
| valuationPrice | number | Current market valuation price |
| currency | string | Currency of the valuation price (EUR) |
| country | string | Country code used for regional pricing |
| fuel | string | Fuel filter that was applied (only present when supplied in the request) |
| kw | number | Engine power filter (kW) that was applied (only present when supplied in the request) |
| mileage | number | Mileage filter (km) that was applied (only present when supplied in the request) |
Error Codes
Bad Request
Missing or invalid parameters. Specific messages include:
Make parameter is requiredModel parameter is requiredYear parameter is required and must be a valid numberYear must be between 1900 and {currentYear + 1}Country parameter is requiredInvalid country code. Supported countries: ...Unsupported fuel type: X. Supported fuel types: petrol, diesel, electric, hybrid, lpg, cng, hydrogenParameter kw must be an integer between 0 and 2000Parameter mileage must be an integer between 0 and 1000000
Forbidden
Invalid or missing API token
Not Found
Vehicle valuation not found for the specified make, model, and year
Internal Server Error
Server encountered an error processing the request
Service Unavailable
External valuation service is temporarily unavailable
Important Notes
- •Make and model parameters are case-insensitive and will be normalized to lowercase
- •Year must be between 1900 and the current year + 1
- •
countryis required so the valuation reflects the right regional market.fuel,kw, andmileageremain optional. - •When
fuel,kw, ormileageare supplied, they are echoed back on the response. - •If no valuation is available for the supplied configuration (make, model, year, and any filters), the endpoint returns a 404
- •Valuation prices are based on current market data and regional factors
- •Each successful request consumes 1 API credit from your monthly allowance
- •Response data is cached for improved performance
Recommended client-side strategy
If you want the tightest valuation possible but with a safe fallback, query in order of decreasing specificity and stop on the first 200:
make+model+year+country+fuel+kw+mileagemake+model+year+country+fuelmake+model+year+country
Each step relaxes one constraint and trades accuracy for sample size.