Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-08-061935150.4 KB
Valuation

Get vehicle valuation

Get current market valuation for a vehicle based on make, model, year, and country (all required). Supports 24 countries including EU, UK, US, and others. Optional fuel and kw (engine power in kW) filters narrow the valuation to a specific drivetrain variant. Optional mileage (current vehicle mileage in km) refines the valuation. Applied filters are echoed back on the response. Valuations are keyed per base model — use canonical base-model names (vw, mercedes-benz, 3-series, s-class, golf) rather than aliases, trim codes, or generation suffixes; trim-level valuations are not available. Requests for a model year that was never produced, or a model not sold in the requested market, return a 404 with an explanatory message; unsupported makes return a 400 with a did-you-mean suggestion for near-misses. Returns 404 when no valuation is available for the supplied configuration.

get/vehicle-valuation

Query parameters

make'acura' | 'alfa-romeo' | 'audi' | 'bmw' | 'cadillac' | 'chevrolet' | 'citroen' | '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' | 'skoda' | 'subaru' | 'suzuki' | 'tesla' | 'toyota' | 'volvo' | 'vw' required
Example:bmw

Vehicle manufacturer name (40 makes supported, case-insensitive). Use the canonical name from the enum (vw, mercedes-benz); makes outside the supported list return a 400 with a did-you-mean suggestion for near-misses.

modelstring required
Example:X6

Vehicle model name (case-insensitive). Valuations are keyed per base model — use the base model name (3-series, s-class, golf) rather than trim codes (320d, s560) or generation suffixes (golf 7).

yearinteger required
Example:2019

Vehicle manufacturing year (1900 to current year + 1)

country'CZ' | 'SK' | 'DE' | 'AT' | 'CH' | 'FR' | 'PL' | 'RO' | 'HU' | 'HR' | 'PT' | 'BG' | 'SI' | 'RS' | 'NL' | 'LT' | 'BE' | 'ES' | 'IE' | 'IT' | 'UK' | 'NO' | 'SE' | 'US' required
Example:CZ

ISO 3166-1 alpha-2 country code for market-specific valuation

fuel'petrol' | 'diesel' | 'electric' | 'hybrid' | 'lpg' | 'cng' | 'hydrogen'
Example:diesel

Vehicle fuel type (case-insensitive). Narrows the valuation to a specific drivetrain variant.

kwinteger
Example:110

Engine power in kW. Narrows the valuation to a specific drivetrain variant. Echoed back on the response when supplied.

mileageinteger
Example:80000

Current vehicle mileage in km. Refines the valuation for the supplied make/model/year/country. Echoed back on the response when supplied.

Response

Vehicle valuation result

makestring required
modelstring required
yearinteger required
valuationPriceinteger required

Estimated market value

currencystring required

Currency of the valuation price. US valuations are returned in USD; all other markets are returned in EUR.

countrystring required

Market country for valuation

fuel'petrol' | 'diesel' | 'electric' | 'hybrid' | 'lpg' | 'cng' | 'hydrogen'

Fuel type filter applied (only present when supplied in the request)

kwinteger

Engine power filter applied in kW (only present when supplied in the request).

mileageinteger

Mileage filter applied in km (only present when supplied in the request)

Example response

{
  "make": "bmw",
  "model": "X6",
  "year": 2019,
  "valuationPrice": 18500,
  "currency": "EUR",
  "country": "CZ",
  "fuel": "diesel",
  "kw": 110,
  "mileage": 80000
}