IntegrationsReference
Rate Limits
API rate limits — requests per second, event limits, and file size limits.
The Carrot API enforces the following per-integrator limits.
Limits
| Limit | Test | Production |
|---|---|---|
| Requests per second | 5 | 10 |
| Events per document | 100 | 100 |
| Max file upload size | 10 MB | 10 MB |
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: