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

# Rate Limiting

> Understand and handle API rate limits

## Overview

API access is rate-limited per organization based on your subscription plan. Limits are applied per minute using a **rolling window**.

## Limits by Plan

| Plan       | Requests/minute |
| ---------- | --------------- |
| API        | 100             |
| Plus       | 500             |
| Business   | 2,000           |
| Enterprise | 10,000          |

## Response Headers

Every response includes:

* **X-RateLimit-Limit**: Your plan's limit
* **X-RateLimit-Remaining**: Remaining requests in the current window
* **X-RateLimit-Reset**: Unix timestamp when the window resets

## When You Exceed the Limit

You receive **429 Too Many Requests** with:

* **Retry-After**: Seconds to wait before retrying
* JSON body with `error`, `message`, and optional `retry_after`

## Best Practices

1. **Monitor headers** and throttle when `X-RateLimit-Remaining` is low
2. **Implement exponential backoff** on 429 responses
3. **Respect Retry-After** before retrying
4. **Batch operations** when possible to reduce request count

See [Plans & Pricing](/plans-and-pricing) to upgrade your limit.