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

# Rate Limits

The Affinity API sets a limit on the number of calls that a user can make per minute, and that all
the users on an account can make per month. It also sets a reasonable limit on the number of
concurrent requests it will support from an account at one time.

Requests to **both** Affinity API versions will count toward the one pool of requests allowed for a
user or account. Once a per-minute, monthly, or concurrent rate limit is hit, subsequent requests
will return an error code of 429. **We highly recommend designing your application to handle 429
errors.**

### Per-Minute Limits (User-Level)

To help protect our systems, API requests will be halted at **900 per user, per minute.** We may
also lower this limit on a temporary basis to manage API availability.

### Concurrent Request Limits (Account-Level)

To protect our systems and manage availability across customers, we set a reasonable limit on
concurrent requests at the account level. Customers should not expect to hit this limit unless they
are hitting the API with heavy operations from many concurrent threads at once.

### Monthly Plan Tier Limits (Account-Level)

The overall number of requests you can make per month will depend on your account's plan tier.
**This monthly account-level limit resets at the end of each calendar month.** Current rate limits
by plan tier are:

| Plan Tier  | Calls Per Month |
| ---------- | --------------- |
| Essentials | None            |
| Scale      | 100k            |
| Advanced   | 100k            |
| Enterprise | Unlimited\*     |

\*Per-Minute and Concurrent Request Limits still apply.

### Rate Limit Headers

All API calls will return the following response headers with information about per-minute and
monthly limits:

| Header                           | Description                                             |
| -------------------------------- | ------------------------------------------------------- |
| x-ratelimit-limit-user           | Number of requests allowed per minute for the user      |
| x-ratelimit-limit-user-remaining | Number of requests remaining for the user               |
| x-ratelimit-limit-user-reset     | Time in seconds before the limit resets for the user    |
| x-ratelimit-limit-org            | Number of requests allowed per month for the account    |
| x-ratelimit-limit-org-remaining  | Number of requests remaining for the account            |
| x-ratelimit-limit-org-reset      | Time in seconds before the limit resets for the account |