Rate Limit Exceeded

Occurs when the client exceeds the allowed number of API requests per time window.

Cause: API rate limit has been exceeded for your account or IP address.

Suggested Action: Wait until the rate limit resets (check retry-after seconds or rate-limit-reset timestamp) before making more requests. Consider implementing exponential backoff in your client.

Common Scenarios:

  • Making more than 10 requests per minute to any endpoint
  • Exceeding daily/monthly API call quotas
  • Burst requests triggering temporary throttling

Response Example

{
  "type": "https://developers.leadboxer.com/docs/rate-limit-exceeded",
  "title": "Rate Limit Exceeded",
  "status": 429,
  "detail": "API rate limit exceeded",
  "instance": "/v1/user-datasets",
  "retry-after": 43,
  "rate-limit": 2,
  "rate-limit-remaining": 0,
  "rate-limit-period": "minute",
  "rate-limit-reset": 1766565255
}

HTTP Status

429 Too Many Requests

Additional Fields

  • retry-after: Wait time in seconds before retrying
  • rate-limit: Maximum allowed requests in the period
  • rate-limit-remaining: Request remaining in a window
  • rate-limit-period: Time window (minute)
  • rate-limit-reset: Exact timestamp when limit resets