API v1
VINdata API
RESTful JSON API for decoding European VINs. Returns normalized vehicle data in <200 ms for cached results, with optional AI enrichment modules.
Fast
<200ms cached
Secure
API key auth
RESTful
JSON over HTTPS
Authentication
Include your API key in every request via the x-api-key header. Query-string keys are not accepted. Generate keys from Settings.
curl -H "x-api-key: YOUR_API_KEY" "https://vindata.io/api/public/api-vin-decode?vin=WVGZZZ5NZNW531198"Quickstart
Decode your first VIN in 30 seconds:
- Sign up and create an API key in Settings → API Keys
- Send a GET request to
/api-vin-decode - Parse the JSON response
curl "https://vindata.io/api/public/api-vin-decode?vin=WVGZZZ5NZNW531198" \
-H "x-api-key: vd_live_..."Errors & rate limits
All errors return JSON with an error field. Usage is tracked monthly per API key — when exceeded you'll get 429.
| Code | Meaning |
|---|---|
400 | Invalid or malformed VIN |
401 | Missing API key |
403 | Invalid or inactive API key |
429 | Monthly limit reached |
502 | Upstream provider failure |