Errors & rate limits
Standard HTTP status codes and plan rate limits. Response bodies follow { statusCode, message, error } once product API is live.
Rate limits by plan
| Plan | Limit |
|---|---|
| Starter | 5 requests / second |
| Growth | 15 requests / second |
| Scale | 50 requests / second |
| Enterprise | Custom |
HTTP error codes
400Bad RequestInvalid VIN, missing parameter, or malformed request body.
401UnauthorizedMissing or invalid API key.
403ForbiddenEndpoint not available on your current plan.
404Not FoundResource not found (unknown VIN, plate, etc.).
429Too Many RequestsRate limit or monthly quota exceeded. Retry after the period indicated in Retry-After.
502Bad GatewayUpstream data provider temporarily unavailable.
503Service UnavailablePlanned maintenance or overload. Check /status.
Pricing and included volumes: compare plans.