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

# Rate limits

> The per-organization request limit, the 429 response and its Retry-After header, what counts as a request, and how to stay under the limit by batching.

Each organization may make **1,000 requests per minute per endpoint**. The limit is a circuit breaker for runaway loops and leaked keys, set well above normal traffic, not a quota to budget around.

## The response

Over the limit, requests are answered `429` for the rest of that minute:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-Request-Id: 7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f
```

```json theme={null}
{ "error": "rate_limit_exceeded", "message": "Request rate limit exceeded for this organization; retry after the current minute ends." }
```

`Retry-After` is the number of seconds until the current minute ends. Browsers can read it; it is exposed through CORS.

## What counts

One HTTP request is one unit, whatever it carries. A batch of 200 events is one request; a batch of 50 decisions is one request. Each endpoint has its own counter, so a burst of events never blocks decisions. Test and live keys share the organization's counters.

## Staying under it

* **Batch events.** Queue them and flush in batches of up to 200; the server SDK does this at five seconds or a hundred events, whichever comes first. See [Batch calls](https://docs.trycurious.ai/guides/batch.md).
* **Decide once per exposure**, and let the client cache the result for that exposure.
* **On a `429`, back off** for `Retry-After` seconds. For `decide`, serve the fallback instead; the deadline has passed by the time the minute ends. For events, retry with the same ids. The server SDK honours `Retry-After` on event flushes.
* **A sudden `429` with no traffic change** usually means a loop or a leaked key. Check the dashboard, and rotate the key if it may have leaked.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.