---
title: "Decode a VIN (basic = free, premium = paid)"
method: GET
path: "/api/v1/vehicles/vin/{vin}"
tags: ["6. VIN Decoding"]
---

# Decode a VIN (basic = free, premium = paid)

`GET /api/v1/vehicles/vin/{vin}`

## Request

- Base URL: `https://api.revcardata.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.revcardata.com/api/v1/vehicles/vin/{vin}`
- Auth: API key in header `X-API-Key`

Decode a 17-character VIN.

`include=basic` (default, free) returns make/model/year/trim + engine + check-digit validation + region.
`include=free` (free) adds every no-key official source that applies:
NHTSA details/WMI/recalls/NCAP/complaints, US EPA and the EU Safety Gate
XML export, plus source-level status and free manual-check links.
`include=recalls` (free) is the same region-aware recall path (US → NHTSA,
EU → Safety Gate) with the free evidence layer attached.
`include=recalls_eu` — forces the EU Safety Gate source.
`include=premium` (paid plans) adds premium specs / exact-build.
`include=history` (paid plans) adds mileage/originality checks (EU: KontrolaTachometru.cz,
RPZV.sk, KO.sk partners; US: NMVTIS/NICB commercial hook).

## Path parameters

- `vin` string, required

## Query parameters

- `include` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `6e6c594b9cc4`: 1 warning
  - changed the pattern of the `query` request parameter `include` from `^(basic|premium|recalls|recalls_eu|history)$` to `^(basic|free|premium|recalls|recalls_eu|history)$`
- **2026-08-28** `6e7262d4aac0`: 1 warning
  - changed the pattern of the `query` request parameter `include` from `^(basic|premium)$` to `^(basic|premium|recalls|recalls_eu|history)$`
- **2026-08-24** `9e80c113b037`: 2 info
  - the endpoint scheme security `APIKeyHeader` was added to the API
  - added the new optional `query` request parameter `include`

[Operation history](https://skmtc.dev/revcardata/apis/revcardata-rest-api/changes/api/v1/vehicles/vin/:vin/get.md)

---

[API](https://skmtc.dev/revcardata/apis/revcardata-rest-api.md) - [All operations](https://skmtc.dev/revcardata/apis/revcardata-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/revcardata/apis/revcardata-rest-api/revisions/58cfa49a4e4a?raw)