Vindec — VIN Decoder API

OpenAPI 3.0 reference for the Vindec VIN-decoding API by FAPI — a paid B2B service.

Live docs: https://fapi-dev.github.io/vindec-openapi/

What's in this repo

• openapi.yml — the spec itself. Generate clients in any language with openapi-generator, or import into Postman / Insomnia / Bruno.
• index.html — Scalar renderer pointing at the spec. Served via GitHub Pages.

What the API does

GET /decode/{vin} accepts a 17-character VIN and returns a slim vehicle card:

• brand, model, modification — vehicle identification.
• model year, body type, fuel type, engine displacement, power (kW), transmission, drive type — basic technical attributes.
• confidence — exact / partial / brand_only — an explicit level so the caller knows how complete the result is.

The set of returned fields scales with confidence. When the model cannot be identified, the response still returns the brand (confidence=brand_only) instead of failing — callers degrade gracefully.

The endpoint is rate-limited by client IP (default 20 requests / minute). For production volumes — request access below.

Quick example

curl https://api.fapi.iisis.ru/vindec/v1/decode/XWF0AHL35D0011102

Returns:

{
  "vin": "XWF0AHL35D0011102",
  "brand_name": "OPEL",
  "model_name": "ASTRA H FAMILY",
  "modification_name": "1.6 (Z16XEP)",
  "model_year": 2013,
  "body_type": "Sedan",
  "fuel_type": "Petrol",
  "displacement_cc": 1598,
  "power_kw": 85,
  "transmission": "Manual",
  "drive_type": "FWD",
  "confidence": "exact"
}

Error messages are returned in Russian — see ErrorResponse in the spec.

Pricing & access

Vindec is a paid B2B service. There is no free tier or shared demo key.

To request access, write to fapi@iisis.ru with:

• your company name and use-case;
• estimated monthly volume of decode requests;
• target integration (web storefront, ERP, mobile app, custom).

We respond within one business day with pricing and a personal API key.

License

This OpenAPI specification is published under Apache 2.0. Use of the Vindec API itself is governed by a separate paid subscription agreement — see "Pricing & access".