Limits
Live requests have no per-minute rate limit and no burst quota. These are the limits there are.
| Limit | Value | Response |
|---|---|---|
| File size | 50MB | 413 file_too_large |
| Pages, synchronous | 60 | 413 too_many_pages |
Pages, with async | 500 | 413 too_many_pages |
| Synchronous reads in flight | 4 per account, live keys only | 429 too_many_concurrent_requests |
| Pages per calendar month | 25,000 unless raised, live keys only | 402 monthly_cap_reached |
| Test requests per minute | 120 per account | 429 too_many_test_requests |
| Idempotency keys | Held for 24 hours | 409 idempotency_key_not_replayable |
metadata | 20 keys of 1 to 40 characters, values up to 500 | 400 invalid_metadata |
| List page size | 1 to 100, default 20 | Clamped |
| Webhook endpoints | 5 per account | Refused in the console |
| Collection files | 24 per collection | Refused on the hosted page |
| Retention | 30 days by default, 1 to 90 | 404 document_not_found once deleted |
Concurrency#
4 synchronous reads may be in flight at once per account. There is no per-minute quota, so 4 in the air continuously runs all day. Async requests are never refused for concurrency: they wait for a free slot and start in order. For a queue of thousands of statements, send them with async=true and collect the results by webhook.
The monthly cap#
Every account has a page ceiling for the calendar month. It stops a runaway loop on your side turning into an invoice. There is nothing to buy: tell us your volume and it moves.
The cap counts every page read on a live key, free pages included. A file that would pass it is refused whole. The window rolls on your first request of a new month, so there is nothing to wait for. Errors and failed reads do not count against it.
Test keys#
A test key has no concurrency limit, spends no free pages and counts against no cap. It is limited to 120 requests a minute instead. See Test mode.
Read duration#
10 to 40 seconds, depending on how many rows the statement holds. A long multi-month statement, a scan or a photo takes longer. Set a client timeout of at least 180 seconds, or send with async=true.
Errors are free#
None of these responses are billable, and none of them spend the monthly cap.