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

# Rate Limits & Request Quotas

> Usage limits for the Person API.

The Person API enforces two types of limits: a per-request item cap and a per-minute throughput limit. Both are checked on every request before processing begins.

## Limits

| Limit                 | Value                  |
| --------------------- | ---------------------- |
| Max items per request | 100                    |
| Max items per minute  | 600 (paid) / 5 (trial) |
| Concurrent requests   | No strict limit        |

<Info>
  The per-minute limit depends on the account type: **600 items/min** for paid accounts, **5 items/min** for trial accounts.
</Info>

## Exceeding the Limits

**More than 100 items in a single request** — returns HTTP `406`:

```json theme={null}
{ "error": "Maximum 100 items are allowed in one request" }
```

**Per-minute limit exceeded** — returns HTTP `429`:

```json theme={null}
{ "error": "Limit of 600 items per minute is exceeded" }
```

Retry logic with **exponential backoff** should be implemented to handle `429` responses gracefully.

## Examples

* 6 requests × 100 items = 600 items/min ✓
* 600 requests × 1 item = 600 items/min ✓
* 7 requests × 100 items = 700 items/min ✗ → `429`