IntegrationsReference
Rate Limits
API rate limits — requests per second, event limits, and file size limits.
Last updated on
The Carrot API enforces the following limits per API client.
Limits
| Limit | Value |
|---|---|
| Requests per second (sustained) | 20 |
| Burst allowance | 30 requests |
| Events per document | 100 |
| Max file upload size | 10 MB |
Throttling is applied per API client and is identical in test and production — the environment is selected by your credential, not by a separate throttle tier. Size your client-side token bucket against the burst allowance, not the sustained rate alone.
Handling throttling
- Exceeding request throughput returns a
429response with{"message": "Too Many Requests"}. - Apply client-side token bucket or leaky bucket rate limiting.
- Smooth bursts; do not rely on minute-level averages only.
Related references: