GET /v1/vin/{vin}
Decode a VIN and list known lots/listings
Decode a VIN and list known lots/listings
Decodes the VIN (NHTSA vPIC + WMI country/US-origin) and returns lots and listings with this VIN that the platform has seen (active and removed). If the decoder is down, specs is null with a warning and cached listings are still returned. Requires scope read:listings.
- Автентифікація: заголовок
Authorization: Bearer rv_live_...(API-ключі та scopes) - Потрібний scope:
read:listings
openapi.json) і подається англійською, як у самому API.Параметри
| Поле | Де | Тип | Обов’язк. | Опис |
|---|---|---|---|---|
vin | path | string | так | 17-character VIN (letters I, O, Q are not allowed). Spaces and dashes are ignored. |
Відповіді
200
Decoded VIN and known listings.
application/json · Схема: VinResponse
| Поле | Тип | Обов’язк. | Опис |
|---|---|---|---|
vin | string | так | |
validation | object | так | |
validation.valid | boolean | так | |
validation.warnings | string[] | так | |
validation.check_digit | object | так | |
specs | object | так | Decoded specs (NHTSA vPIC + WMI). null if the decoder is unavailable. |
specs.vin | string | так | |
specs.make | string | null | так | |
specs.model | string | null | так | |
specs.year | integer | null | так | |
specs.trim | string | null | так | |
specs.body | "sedan" | "hatchback" | "wagon" | "suv" | "crossover" | "coupe" | "convertible" | "minivan" | "van" | "pickup" | "truck" | "motorcycle" | "other" | null | так | |
specs.fuel | "petrol" | "diesel" | "hybrid" | "phev" | "ev" | "lpg" | "cng" | "hydrogen" | "other" | null | так | |
specs.engineCc | number | null | так | |
specs.cylinders | number | null | так | |
specs.powerKw | number | null | так | |
specs.drive | "fwd" | "rwd" | "awd" | "4wd" | null | так | |
specs.gearbox | "manual" | "automatic" | "cvt" | "robot" | "other" | null | так | |
specs.plantCountry | string | null | так | |
specs.wmiCountry | string | null | так | |
specs.isUsOrigin | boolean | null | так | |
decoder | object | так | |
decoder.mode | "live" | "test" | "mock" | так | |
decoder.error | string | null | так | |
listings | object[] | так | Lots/listings with this VIN known to the platform cache, newest first. |
listings[].source_key | string | ні | |
listings[].external_id | string | ні | |
listings[].url | string | ні | |
listings[].title | string | ні | |
listings[].status | "active" | "removed" | ні | removed: the listing disappeared from the source (usually sold or taken down). |
listings[].price | object | ні | |
listings[].price_eur | number | null | ні | |
listings[].price_type | "fixed" | "current_bid" | "buy_now" | "estimate" | "unknown" | ні | |
listings[].mileage_km | number | null | ні | |
listings[].market | "us" | "eu" | "cn" | "kr" | "ua" | "ge" | ні | |
listings[].auction | object | ні | |
listings[].location_country | string | null | ні | |
listings[].first_seen_at | string (date-time) | ні | |
listings[].last_seen_at | string (date-time) | ні | |
listings[].removed_at | string | null (date-time) | ні | |
listings[].fetched_at | string (date-time) | ні | |
warnings | object[] | так | |
warnings[].code | string | ні | |
warnings[].message | string | ні |
400
Invalid request parameters or body (code validation_error).
application/problem+json · Схема: Problem
401
Missing, malformed, unknown, revoked or expired API key (code unauthorized).
application/problem+json · Схема: Problem
403
The API key lacks the scope required by this endpoint (code insufficient_scope).
application/problem+json · Схема: Problem
429
Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.
application/problem+json · Схема: Problem
Приклад
curl -s "https://api.importos.app/v1/vin/1HGCM82633A004352" \
-H "Authorization: Bearer $IMPORTOS_API_KEY"