API Documentation
All requests use HTTPS. Responses are JSON.
Authentication
Create an API key from your dashboard. Pass it as a Bearer token in the Authorization header.
Authorization: Bearer vd_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxDecode a VIN
GET /v1/decode/{vin}
curl https://your-domain.com/v1/decode/1HGCM82633A123456 \
-H "Authorization: Bearer vd_live_..."Returns decoded vehicle details. Cached results don't count against quota.
Quotas & rate limits
- Every account gets 1,000 successful calls / calendar month.
- Cached responses still count as calls but are much faster.
- Public homepage is IP-limited to a few lookups per hour.
Errors
| Status | Meaning |
|---|---|
| 400 | Malformed VIN |
| 401 | Missing / invalid API key |
| 429 | Quota exceeded |
| 502 | Upstream decode error |