Developer Docs

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.

PlanRequests per minuteBurst allowance
Free6010 requests in 1 second
Pro60050 requests in 1 second
Enterprise6,000Negotiated

Rate limit headers

HeaderMeaning
X-RateLimit-LimitThe number of requests allowed in the current window.
X-RateLimit-RemainingThe number of requests left in the current window.
X-RateLimit-ResetUnix timestamp (seconds) when the window resets.
Retry-AfterSeconds 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

LimitValue
Maximum JSON body1 MB
Maximum file upload25 MB per file
Maximum URL length8 KB
Maximum header size16 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

ResourceLimit
Stored objects per account10,000 (Free), 500,000 (Pro)
Webhook endpoints per account5 (Free), 50 (Pro)
Request logs retained7 days
Deleted objects recoverable for30 days
Need higher limits? Enterprise plans can raise rate limits and quotas. Contact support with your expected request volume and we will review it.

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.