Skip to content
DocsAPI reference

Limits

Live requests have no per-minute rate limit and no burst quota. These are the limits there are.

LimitValueResponse
File size50MB413 file_too_large
Pages, synchronous60413 too_many_pages
Pages, with async500413 too_many_pages
Synchronous reads in flight4 per account, live keys only429 too_many_concurrent_requests
Pages per calendar month25,000 unless raised, live keys only402 monthly_cap_reached
Test requests per minute120 per account429 too_many_test_requests
Idempotency keysHeld for 24 hours409 idempotency_key_not_replayable
metadata20 keys of 1 to 40 characters, values up to 500400 invalid_metadata
List page size1 to 100, default 20Clamped
Webhook endpoints5 per accountRefused in the console
Collection files24 per collectionRefused on the hosted page
Retention30 days by default, 1 to 90404 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.

402free_pages_exhausted
The free pages are used up and no payment method is on file.
402not_enough_free_pages
The file has more pages than the free pages left, and no payment method is on file.
402monthly_cap_reached
This file would take the account past its pages for the calendar month.
402canceled
Billing for this account was cancelled.
413file_too_large
Over 50MB.
413too_many_pages
Over 60 pages in a synchronous request, or over 500 at all.
429too_many_concurrent_requests
More than 4 synchronous reads in flight at once.
429too_many_test_requests
More than 120 test requests in one minute.
Something wrong or missing on this page? [email protected]