Limits
This page describes the rate limits, payload sizes, and quotas that apply to API requests.
Rate limits
Requests are limited per API key using a fixed one-minute window. Every response includes headers that describe your current standing.
| Plan | Requests per minute | Burst allowance |
|---|---|---|
| Free | 60 | 10 requests in 1 second |
| Pro | 600 | 50 requests in 1 second |
| Enterprise | 6,000 | Negotiated |
Rate limit headers
| Header | Meaning |
|---|---|
X-RateLimit-Limit | The number of requests allowed in the current window. |
X-RateLimit-Remaining | The number of requests left in the current window. |
X-RateLimit-Reset | Unix timestamp (seconds) when the window resets. |
Retry-After | Seconds to wait before retrying. Only sent with a 429 response. |
When you exceed your limit, the API responds with 429 Too Many Requests. Wait for the number of seconds in Retry-After before sending another request.
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1718200860
{"error": "rate_limited", "message": "Too many requests. Try again in 12 seconds."}
Request size
| Limit | Value |
|---|---|
| Maximum JSON body | 1 MB |
| Maximum file upload | 25 MB per file |
| Maximum URL length | 8 KB |
| Maximum header size | 16 KB |
Requests above these sizes are rejected with 413 Payload Too Large or 414 URI Too Long.
Pagination
List endpoints return at most 100 items per page. The default page size is 20. Use the limit query parameter to request a different size, up to the maximum.
GET /v1/items?limit=100&cursor=eyJpZCI6NDJ9
Quotas and retention
| Resource | Limit |
|---|---|
| Stored objects per account | 10,000 (Free), 500,000 (Pro) |
| Webhook endpoints per account | 5 (Free), 50 (Pro) |
| Request logs retained | 7 days |
| Deleted objects recoverable for | 30 days |
Requesting an increase
If your integration is hitting limits during normal operation, first check whether you can batch requests or cache responses. If you still need more capacity, reach out through your account dashboard.