# 7zap API — VIN decoder with engine & factory spec, OEM parts-catalogue groups for 70 car makes

> Decode a 17-character VIN with 7zap's OEM catalogue: make, model series, generation, year, a picture of the generation, and — from the maker's own parts catalogue — the factory configuration where 7zap has it: engine (code, size, fuel), gearbox, body, drive, steering, market, trim, production date or production window, and for some makes the engine and gearbox serial numbers and paint colour. Also returns 7zap's catalogue link for this exact car, the `vehicle_code` that `parts_catalog` takes, and an `autodoc` block (Autodoc maker slug + the next calls) to go on to parts with prices. Measured 2026-11-19 on 34 real EU VINs from car listings: 21 decoded, make and model right on all 21 (VW, Audi, BMW, Skoda, Seat, Cupra, Renault, Hyundai, Kia, Toyota, Nissan, Opel, Mercedes, Citroen, Fiat, Dacia); 13 came back NOT_FOUND (Ford 0/2, Peugeot 0/2, Volvo 0/2, Mazda, Tesla, and some models of other makes). How detailed the factory facts are depends on the make: Toyota, Nissan, Hyundai, Kia, Opel, Renault, Dacia, Citroen and BMW include the engine (12 of the 21); VW-group cars carry body, year and production window. `year` is 7zap's; where 7zap derives it from the generation range `year_is_estimate` is true.
> ReefAPI engine `7zap` · 2 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/7zap/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/7zap/v1/vin_decode — 2 credits
Decode a 17-character VIN with 7zap's OEM catalogue: make, model series, generation, year, a picture of the generation, and — from the maker's own parts catalogue — the factory configuration where 7zap has it: engine (code, size, fuel), gearbox, body, drive, steering, market, trim, production date or production window, and for some makes the engine and gearbox serial numbers and paint colour. Also returns 7zap's catalogue link for this exact car, the `vehicle_code` that `parts_catalog` takes, and an `autodoc` block (Autodoc maker slug + the next calls) to go on to parts with prices. Measured 2026-11-19 on 34 real EU VINs from car listings: 21 decoded, make and model right on all 21 (VW, Audi, BMW, Skoda, Seat, Cupra, Renault, Hyundai, Kia, Toyota, Nissan, Opel, Mercedes, Citroen, Fiat, Dacia); 13 came back NOT_FOUND (Ford 0/2, Peugeot 0/2, Volvo 0/2, Mazda, Tesla, and some models of other makes). How detailed the factory facts are depends on the make: Toyota, Nissan, Hyundai, Kia, Opel, Renault, Dacia, Citroen and BMW include the engine (12 of the 21); VW-group cars carry body, year and production window. `year` is 7zap's; where 7zap derives it from the generation range `year_is_estimate` is true.

**Parameters:**
- `vin` (string, optional) — The 17-character vehicle identification number (letters I, O and Q never occur). Spaces, dashes and dots are removed.
- `language` (enum, optional, default "en") — Language of the names 7zap returns (group and assembly names, some catalogue values) and of the catalogue link. 32 languages, the ones 7zap's own site offers. [one of: en, da, de, et, es, fr, hr, it, lv, lt, hu, nl, no, pl, pt, ro, sk, sl, fi, sv, tr, cs, el, sr, bg, ru, uk, ar, hi, th, ja, zh]
- `details` (boolean, optional, default true) — true (default) also reads the car's catalogue entry: engine, gearbox, body, production window and the other factory facts 7zap has for this make, the generation's years and region, and the 7zap catalogue link. false returns only the fast VIN preview (make, model, generation, year, vehicle_code).

**Returns:** vin, wmi{wmi, region}, make, make_slug, series, model, generation, year, year_is_estimate, attributes{}, image_url, vehicle_code, variants[]{index, label, badges, vehicle_code}, details_status (ok|skipped|unavailable), generation_years{from, to}, catalog_region{code, name}, vehicle_type, label, engine, transmission, body, drive, steering, market, trim, production_date, production_window{from, to}, specification[]{name, value} (every factory fact 7zap lists, in its words), generation_image_url, catalog_url, generation_url, autodoc{maker, series_hint, vehicle_lookup, vehicle_by_vin, note}. Fields 7zap does not publish for the make are null.

**Example request body:**
```json
{
  "vin": "WVWZZZAUZLW053403"
}
```

### POST https://api.reefapi.com/7zap/v1/parts_catalog — 2 credits
The OEM parts-catalogue structure of one car, as 7zap shows it: top-level groups (Engine, Transmission, Chassis, Body, Interior, Electrical, Accessories, Maintenance) → subgroups → assemblies, each assembly with its code, name, the maker's applicability codes (engine / equipment codes it applies to) and a diagram thumbnail. 130-1 500 assemblies per car. Give a `vin`, or the `vehicle_code` + `make` from `vin_decode`; narrow with `query` (words in the assembly name) or `group`. Part numbers are NOT included: 7zap shows OE numbers only to signed-in members (logged out they are masked), so this action returns none rather than masked ones.

**Parameters:**
- `vin` (string, optional) — The 17-character vehicle identification number (letters I, O and Q never occur). Spaces, dashes and dots are removed.
- `vehicle_code` (string, optional) — 7zap's code for one car, as `vin_decode` returns it (`vehicle_code`). Give this together with `make` instead of `vin` to read the catalogue without decoding the VIN again.
- `make` (string, optional) — 7zap's make slug (`make_slug` from `vin_decode`: volkswagen, bmw, mercedes, skoda …). Required with `vehicle_code`.
- `query` (string, optional) — Keep only assemblies whose name contains every word (case-insensitive, in the chosen language or the English slug), e.g. 'brake', 'water pump', 'timing'.
- `group` (string, optional) — Keep only the top-level groups whose name contains these words (Engine, Transmission/Drivetrain, Chassis Systems, Body/Exterior, Interior/Safety, Electrical/Electronic, Accessories/Tools, Maintenance Parts — names vary by make and language).
- `language` (enum, optional, default "en") — Language of the names 7zap returns (group and assembly names, some catalogue values) and of the catalogue link. 32 languages, the ones 7zap's own site offers. [one of: en, da, de, et, es, fr, hr, it, lv, lt, hu, nl, no, pl, pt, ro, sk, sl, fi, sv, tr, cs, el, sr, bg, ru, uk, ar, hi, th, ja, zh]
- `thumbnails` (boolean, optional, default true) — Include each assembly's diagram thumbnail URL (small webp). false makes the answer about half the size.

**Returns:** vehicle{vin, make_slug, vehicle_code, series, model, generation, generation_years, catalog_region, label, year, engine, transmission, production_window, catalog_url, generation_url}, groups[]{group_code, name, name_en, description, assemblies[]{assembly_code, name, name_en, description, applicability, thumbnail_url}, subgroups[] (same shape)}, assemblies_returned, assemblies_total, query, group

**Example request body:**
```json
{
  "vin": "W0LGT8GS1F1095696",
  "query": "brake"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=7zap
- Human docs page: https://reefapi.com/docs/7zap
- Overview page: https://reefapi.com/7zap-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
