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

# Rate limits

> Firmium API rate limits and how to handle them

# Rate limits

Firmium rate-limits the API to keep usage fair and the system stable. Every request counts against your limit.

## Overview

* Limits cap how many requests you can make in a time window.
* If you exceed the limit, the API returns 429 until the window resets.

## Limits

* Default for authenticated users: **100 requests per minute** (plan-dependent).
* Current values are sent in `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`.

### Example headers

```
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1712345678
```

## Errors

### 429 Too Many Requests

```json theme={null}
{
  "error": "Rate limit exceeded. Please try again later.",
  "limit": 100,
  "reset_in": 42,
  "reset_at": "12:34:56"
}
```

## Best practices

1. **Backoff:** Use exponential backoff on 429.
2. **Monitor:** Watch the rate-limit headers.
3. **Cache:** Avoid repeat requests for data that rarely changes.

## Related

* [Authentication](/authentication)
* [Error codes](/error-codes)