BIMMERVINAPI
Reference

The full API over HTTPS.

One REST API. One credit balance. Below is the consolidated catalog of what's available on standard accounts. Full request/response examples are in your dashboard documentation after sign-up.

Lookup & data

VIN Search

POST /vehicle-state

Vehicle-state lookup by VIN. Returns ECU configuration, installed equipment, current iLevel, head-unit type, and factory options — the source data for everything else.

Volume tier 0+ €0.20· 100+ €0.15· 300+ €0.10· 1,000+ €0.08· 2,000+ €0.07
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
Show example response 
Loading…
0.20 credits
base / call

Vehicle Order (FA) — JSON

POST /vehicle-order-json

Factory order data — original equipment list, build configuration, FA codes — returned as JSON.

3.00 credits
base / call

VIN Lookup + Head Unit Identification + CarPlay Compatibility Check

POST /fullvindata-plus-carplaycheck

Single call returning vehicle data and identifying head-unit type, map version, and CarPlay compatibility. Also reports Fullscreen Add-On compatibility and EntryEVO Wi-Fi port presence.

Volume tier 0+ €0.25· 100+ €0.20· 300+ €0.15· 1,000+ €0.13· 2,000+ €0.12
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
Show example response 
Loading…
0.25 credits
base / call

Navigation map activation (FSC)

FSC Code Generation

POST /fsc-code

Generate map activation FSC codes for Premium, Route, Motion, Move, EVO ID4, and Next maps.

Volume tier 0+ €10· 10+ €8
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
8.00 credits
base / call

FSC Repair Kit

POST /repairkit

Downloadable repair-kit package from the database.

Volume tier 0+ €8· 20+ €7· 35+ €6
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
6.00 credits
base / call

Retrofit Kits

Retrofit Kit — EVO ID5/6 (cable coding)

POST /retrofit-kit-evo

Generates a Feature Installer code for an EVO ID5/6 navigation retrofit kit. Apple CarPlay is optional — set carplay=true to also enable it (adds the fullscreen options); leave it off for navigation-only coding. Video In Motion is an independent yes/no option.

20.00 credits
base / call

Retrofit Kit — EVO ID5/6 (USB coding)

POST /retrofit-kit-evo-usb

Generates a UPD file (USB pack) for an EVO ID5/6 navigation retrofit kit. Apple CarPlay is optional — set carplay=true to also enable it (adds the fullscreen options); leave it off for navigation-only coding. Video In Motion is an independent yes/no option. Firmware: works up to (but not including) 18-11; on 18-11 or above it will not work.

20.00 credits
base / call

CIC Retrofit Pack

POST /retrofit-kit-cic

Full navigation retrofit pack for CIC (Premium) head units — a ZIP of signed FSC files, uploaded manually with coding software (no USB stick / UPD bin for this unit). Pass VIN + region_code (call without region_code to list the available regions for the unit).

10.00 credits
base / call

NBT Retrofit Pack (USB)

POST /retrofit-kit-nbt

Full navigation retrofit pack for NBT head units — a ZIP of signed FSC files plus a UPD bin, installed via USB stick. Pass VIN + region_code (call without region_code to list the available regions for the unit).

15.00 credits
base / call

EVO ID4 Retrofit Pack (USB)

POST /retrofit-kit-evo-id4

Full navigation retrofit pack for EVO ID4 head units — a ZIP of signed FSC files plus a UPD bin, installed via USB stick. Pass VIN + region_code (call without region_code to list the available regions for the unit).

15.00 credits
base / call

CarPlay activation

EVO ID5/6 CarPlay Activation (cable coding)

POST /carplay-coding

Generates a Feature Installer code to enable CarPlay on compatible EVO ID5/6 head units.

Volume tier 0+ €25· 15+ €20
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
20.00 credits
base / call

EVO ID5/6 CarPlay Activation (USB coding)

POST /carplay-coding-usb

Generates a UPD file to enable CarPlay on compatible EVO ID5/6 head units.

Volume tier 0+ €25· 15+ €20
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
20.00 credits
base / call

EVO ID5/6 Fullscreen CarPlay Add-On (cable coding)

POST /fullscreen-carplay

Generates a Feature Installer code to enable the CarPlay Fullscreen Add-On on compatible EVO ID5/6 head units.

12.00 credits
base / call

EVO ID5/6 Fullscreen CarPlay Add-On (USB coding)

POST /fullscreen-carplay-usb

Generates a UPD file to enable the CarPlay Fullscreen Add-On on compatible EVO ID5/6 head units.

12.00 credits
base / call

Video In Motion

VIM Activation (cable coding)

POST /vim-coding

Generates a Feature Installer code to enable Video In Motion on compatible EVO ID5/6 head units.

7.00 credits
base / call

VIM Activation (USB coding)

POST /vim-coding-usb

Generates a UPD file to enable Video In Motion on compatible EVO ID5/6 head units.

7.00 credits
base / call

VIM NBT (USB)

POST /vim-nbt-usb

Generates a UPD file to enable Video In Motion on older NBT head units.

7.00 credits
base / call

Service & coding

Secure Coding (NCD 2.0)

POST /secure-coding-async

Submit the original or a modified FA/SVT to receive signed NCD coding files. Async — submit returns a job_id, then poll /secure-coding-status until completion (typical 10-50s).

Volume tier 0+ €30· 10+ €25
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
35.00 credits
base / call

SFA Repair Kit

POST /sfa-repair-kit

Generate an SFA repair kit. Used when updating or replacing control units that require secure flashing.

10.00 credits
base / call

VO Coding Fix

POST /vo-coding-fix

Generates a Feature Installer code to fix VO coding on EVO ID5/6 units.

10.00 credits
base / call

Clear SWT

POST /clear-swt

Generates a Feature Installer code to clear SWT records on EVO ID5/6 units.

10.00 credits
base / call

ECU Validation

POST /ecu-validation

Generates an ECU validation JSON file. Required to verify the security status of new ECUs in models from July 2018 onward — typically run after replacing a control unit.

5.00 credits
base / call

Vehicle history

Service History

POST /service-history

Full vehicle service history — factory specs, equipment, technical campaigns, service/repair/key-read log. Returns a ready-to-share HTML report plus the raw structured data.

Volume tier 0+ €7· 15+ €5
Per-call rate drops the moment you cross each threshold. Counts reset on the 1st of each month (UTC).
Show example response 
Loading…
6.00 credits
base / call

Don't see an endpoint you need? [email protected] — we add endpoints regularly and can usually enable a specific one for an existing account.

Authentication

All endpoints require a JWT bearer token, exchanged once per session from your Client ID + Secret via POST https://api.bimmervin.xyz/auth/token. Tokens are valid for 1 hour. Cache and reuse them — don't request a new token per call.

Rate limits

Default: 10 requests/second per account, with a burst of 30. Custom limits available on request.