Rate limits

Rate limits protect the API and can differ by key or environment.

When a limit is reached

The API returns HTTP 429 with the error code rate_limited.

{
  "success": false,
  "request_id": "req_example1234567890",
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please slow down."
  }
}

Recommended retry pattern

Reduce requests

• Reuse a valid bearer token until it nears expiry.
• Cache data for a sensible period when immediate changes are not required.
• Do not call capabilities before every request.
• Do not poll faster than the business need.
• Use one controlled retry process, not retries at several layers.