Skip to content
Last updated

Rate Limit Exceeded

HTTP Status: 429 Too Many Requests
RFC Reference: RFC 9110 Section 4

You have exceeded the API rate limit of 100 requests per minute.

Response

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
RateLimit-Limit: 100
RateLimit-Remaining: 0
RateLimit-Reset: 1699564860
Retry-After: 60

{
  "type": "https://docs.apiera.io/problems/rate-limit-exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit of 100 requests per minute exceeded. Please retry after 60 seconds.",
  "instance": "/v1/products",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000"
}

How to Handle

  1. Check the Retry-After header (in seconds)
  2. Wait for the specified duration
  3. Retry your request

Prevention

  • Monitor RateLimit-Remaining header values
  • Implement exponential backoff
  • Cache responses when possible
  • Use bulk endpoints instead of individual requests

See Rate Limits guide for more details.

Need Help?

Contact support with the correlationId for assistance.