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

# Rate limits

> Check rate limit headers and handle 429 responses.

Rate limits scale with your plan. See [Plans and billing](/platform/plans) for tier thresholds, requests-per-minute (RPM) limits, and monthly caps.

## Prerequisites

* An [Auriko API key](https://auriko.ai/signup?redirectTo=%2Fdashboard%3Ftab%3Dapi-keys)

## Check rate limit headers

Chat completion responses include request-level rate limit headers:

| Header                           | Description                                                               |
| -------------------------------- | ------------------------------------------------------------------------- |
| `Retry-After`                    | Seconds until rate limit resets; present on 429 responses only (RFC 7231) |
| `X-RateLimit-Limit-Requests`     | Requests allowed per window                                               |
| `X-RateLimit-Remaining-Requests` | Requests remaining in current window                                      |
| `X-RateLimit-Reset-Requests`     | ISO 8601 timestamp when the window resets                                 |

## Handle 429 responses

When you exceed a rate limit, the API returns a `429 Too Many Requests` response with a `Retry-After` header:

```json theme={null}
{
  "error": {
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "type": "rate_limit_error",
    "param": null,
    "code": "rate_limit_exceeded",
    "doc_url": "https://docs.auriko.ai/errors/rate_limit_exceeded"
  }
}
```

The Auriko SDK ([Python](/sdk/python), [TypeScript](/sdk/typescript)) retries failed requests with exponential backoff (up to 2 retries by default). For manual handling, see [Error handling — Retry manually](/guides/error-handling#retry-manually).
