Skip to main content
BlueAI
Home/Guides/Rate Limiting

Rate Limiting

How the API handles rate limiting.

|

Overview

The BlueAI API applies rate limiting to protect service stability. When you exceed the rate limit, the API returns a 429 Too Many Requests response.

Rate Limit Headers

Rate limit information is included in response headers:

HeaderDescription
X-RateLimit-LimitMaximum requests per window
X-RateLimit-RemainingRemaining requests in current window
Retry-AfterSeconds to wait before retrying (only on 429)

Best Practices

  • Implement exponential backoff when receiving 429 responses
  • Cache responses where possible to reduce API calls
  • Use bulk endpoints when available instead of individual requests
  • Monitor the X-RateLimit-Remaining header proactively