DOCUMENTATION

Errors and limits

Understand API errors, validation, rate limits, and response headers.

HTTP status codes

400 Invalid VIN or malformed request
401 Missing or invalid API key
403 Scope denied
422 The provider could not decode the VIN
429 Registered-key monthly quota or demo five-VIN daily limit reached
500 Service configuration failure
502 Vehicle-data provider unavailable
503 Authentication database unavailable

Error envelope

            {
  "error": {
    "code": "invalid_api_key",
    "message": "The API key is invalid or inactive."
  }
}

Usage headers

X-Request-Id Registered request correlation ID
X-RateLimit-Limit Registered plan request allowance
X-RateLimit-Remaining Registered requests available in the current period
X-Demo-Limit Distinct demo VIN allowance: 5
X-Demo-Remaining Distinct demo VINs remaining for the current UTC day

Metering behavior

Accepted registered-key requests are counted atomically before endpoint execution. Completion updates status, latency, and error totals without allowing a telemetry failure to replace the customer response. Demo requests use only the in-memory daily VIN counter and do not create usage-table rows.