vinDecoder

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_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Decode 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

StatusMeaning
400Malformed VIN
401Missing / invalid API key
429Quota exceeded
502Upstream decode error