GET /v1/catalog/similar
Similar cars in the EU catalog (count and median price)
Similar cars in the EU catalog (count and median price)
How many similar active listings the platform EU catalog index has (same make/model, year ±1, optional fuel and mileage) and their median price; landed_median_eur is the median turnkey in Ukraine without EU delivery. Only make/model/year/fuel/mileage are sent — no VIN or URL. available:false — the catalog is not configured or unavailable. Requires scope read:listings.
- Authentication: header
Authorization: Bearer rv_live_...(API keys and scopes) - Required scope:
read:listings
openapi.json).Parameters
| Field | In | Type | Required | Description |
|---|---|---|---|---|
make | query | string | yes | Make, e.g. "Volkswagen". |
model | query | string | yes | Model, e.g. "Golf". |
year | query | integer | yes | Model year; similar listings are taken within ±1 year. |
fuel | query | "petrol" | "diesel" | "hybrid" | "phev" | "ev" | "lpg" | "cng" | "hydrogen" | "other" | no | |
mileage_km | query | number | null | no | Mileage in km (±35%, min ±30 000 km). |
Responses
200
Similar listings statistics.
application/json · Schema: CatalogSimilarResponse
| Field | Type | Required | Description |
|---|---|---|---|
available | boolean | yes | false — the catalog index is not configured or unavailable. |
count | integer | yes | Similar active listings in the EU catalog. |
sample_size | integer | yes | Listings used for the statistics (up to 60 most recent, IQR outliers removed). |
median_eur | number | null | yes | |
p25_eur | number | null | yes | |
p75_eur | number | null | yes | |
landed_median_eur | number | null | yes | Median turnkey in Ukraine: price + duty/excise/VAT/fees, EU delivery NOT included. |
as_of | string (date-time) | yes |
400
Invalid request parameters or body (code validation_error).
application/problem+json · Schema: Problem
401
Missing, malformed, unknown, revoked or expired API key (code unauthorized).
application/problem+json · Schema: Problem
403
The API key lacks the scope required by this endpoint (code insufficient_scope).
application/problem+json · Schema: Problem
429
Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.
application/problem+json · Schema: Problem