> ## Documentation Index
> Fetch the complete documentation index at: https://developers.mageloyalty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate Limits

> Rate limiting policy for the Mage Loyalty API.

## Rate limits

The Mage Loyalty API enforces a rate limit of **6 requests per second** per API key using a sliding window.

Exceeding the rate limit returns a `429 Too Many Requests` response:

```json theme={null}
{
  "errors": [
    {
      "status": "429",
      "title": "Too Many Requests",
      "detail": "Rate limit exceeded. Please retry after a short delay."
    }
  ]
}
```

## Best practices

* **Cache responses** where possible to reduce the number of API calls
* **Use pagination** to fetch large datasets in batches rather than making many parallel requests
* **Implement exponential backoff** when you receive a `429` response
* **Use read-only keys** for high-frequency read operations like storefront widgets