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

# Limits

> Rate limits and caps in the Enrichment API.

Limits use a token bucket per key and endpoint class, plus a whole-key bucket. Every answer carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`; a `429` adds `Retry-After`. A `VFN_TEST_` key gets one tenth of each number (at least 1).

| Endpoints | Class | Per second (burst) | Per minute | Per day (IST) |
| - | - | - | - | - |
| Create an enrichment | `enrichmentWrites` | 5 (10) | 60 | 2,000 |
| Create, pause and resume a campaign | `campaignWrites` | 2 (5) | 30 | 500 |
| Every read | `reads` | 20 (40) | 1,200 | none |
| All calls of a key | `wholeKey` | 150 (300) | 6,000 | none |

Record can raise or lower these for a key. Errors and the rate-limit rules that repeat offenders hit are in [Errors](https://docs.userecord.io/blue-collar-api/reference/errors.md).

## Caps

| What | Limit |
| - | - |
| Questions per enrichment | 15, each up to 300 characters |
| Candidates per campaign call | 1,000 |
| Candidates per enrichment, TEST key | 50 |
| Active enrichments, TEST key (per organisation) | 5 |
| Different people into campaigns per key per day (shared with Blue Collar) | 2,000 (TEST key: 200), resets at midnight IST, `429 DAILY_CAP` |
| `limit` on a list | 100 (default 25) |
| Request body | 256 KB |
| `Idempotency-Key` memory | 24 hours |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.