---
title: "Get vehicle valuation"
method: GET
path: "/vehicle-valuation"
tags: ["Valuation"]
---

# Get vehicle 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.

## 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
- `model` string, required
- `year` integer, required
- `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
- `fuel` 'petrol' | 'diesel' | 'electric' | 'hybrid' | 'lpg' | 'cng' | 'hydrogen'
- `kw` integer
- `mileage` integer

## Response `200`

Vehicle valuation result

- ValuationResponse
  - `make` string, required
  - `model` string, required
  - `year` integer, required
  - `valuationPrice` integer, required — Estimated market value
  - `currency` string, required — Currency of the valuation price. US valuations are returned in USD; all other markets are returned in EUR.
  - `country` string, required — Market country for valuation
  - `fuel` 'petrol' | 'diesel' | 'electric' | 'hybrid' | 'lpg' | 'cng' | 'hydrogen' — Fuel type filter applied (only present when supplied in the request)
  - `kw` integer — Engine power filter applied in kW (only present when supplied in the request).
  - `mileage` integer — Mileage filter applied in km (only present when supplied in the request)

## Other responses

- `400` — Missing or invalid parameters, or a make outside the supported list
- `403` — Invalid or missing API key, suspended account, or inactive subscription
- `404` — Valuation not found for specified vehicle. Includes explanatory messages when the model year was never produced or the model is not sold in the requested market.
- `429` — Monthly quota exhausted or per-minute rate limit exceeded. Quota responses carry resetDate; rate-limit responses carry a Retry-After header.

---

[API](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api.md) · [All operations](https://skmtc.dev/carapi/apis/carapi-dev-automotive-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/carapi/carapi-dev-automotive-data-api/revisions/cf1d4e12baca/schema)