> For the complete documentation index, see [llms.txt](https://docs.adaptria.locaria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptria.locaria.com/client-api/rate-limits.md).

# Rate limits

The API gateway applies rate limits to keep the service fair and stable for everyone.

## The limits

Requests are rate limited at two levels:

* **Per IP address** (before authentication): **100 requests per minute**.
* **Per API credential** (after authentication): **60 requests per minute**, applied to all requests regardless of method.

Read the rate-limit headers on each response rather than hard-coding these values, as the configured limits may vary by environment.

## Exceeding a limit

When a limit is exceeded, the API responds with `429 Too Many Requests` and the standard error envelope (`code: RATE_LIMIT_EXCEEDED`).

Rate-limited responses include the following standard response headers, which you can use to pace your requests:

| Header                | Description                                                  |
| --------------------- | ------------------------------------------------------------ |
| `RateLimit-Limit`     | The request limit for the current window.                    |
| `RateLimit-Remaining` | Requests remaining in the current window (`0` when limited). |
| `RateLimit-Reset`     | Unix timestamp (seconds) at which the window resets.         |
| `Retry-After`         | Seconds to wait before retrying.                             |

{% hint style="info" %}
Back off when you receive a `429` and retry after the window resets. Use the `Retry-After` header to decide how long to wait.
{% endhint %}