API

Limits and pricing

On this page

Limits

These are the limits the API enforces today. They are not SLAs.

Document size: Up to 20 MiB inline as bytes_base64. Up to 50 MiB staged via `POST /v1/uploads`, passing the returned key as document.upload_key.
Pages: Up to 200 pages per document. The sync path (POST /v1/extract) accepts up to 20 pages; over that it returns document_too_large.
Long documents: Use POST /v1/jobs. The sync path is tuned for short documents.
Words: Up to 80,000 words of document text. Over that returns document_too_large.
Schema size: Up to 800 leaf fields per schema. Over that returns invalid_schema.
Result retention: A succeeded job’s result is available on GET /v1/jobs/:id for 24 hours, then the lookup returns 404. Store results on your side.
Key revocation: Revoking a key takes effect within about 60 seconds. Until the server-side key cache expires, in-flight traffic on the old key can still authenticate.

Default: 10 requests per second per account, as a token bucket: short bursts pass, a sustained overrun returns 429 rate_limited. All keys on an account share the bucket.
Free accounts: An account that has not topped up or saved a card runs at 2 requests per second and 100 pages per day. A first top-up or a saved card moves it to the default limits.
On 429: The response carries a Retry-After header and error.retry_after (seconds). Wait that long, then retry. The SDKs do this automatically for waits up to 60 seconds.
Daily quota: An account can carry a daily page quota, counted against the pages you are billed for. Free accounts have one. Accounts that have topped up or saved a card do not, unless a quota is set on a key. All keys on the account share the count.
Exempt: GET /v1/jobs/:id is not rate limited; poll freely.
Raising limits: Defaults can be raised. Email hello@velrim.com from your account address with the rate you need. If you have more than one key, mention the key's name.

Price: $0.02 per page, no surcharges. Grounding and per-field confidence are included. Scanned and digital documents cost the same; there is no document-type fee and no volume tier.
Billed on success: You are billed meta.billed_pages. A failed extraction (extraction_failed) is not billed.
Wallet: Prepaid. Top up any amount from $5; presets $20 / $100 / $500. Paid balance does not expire.
Never negative: A job that would take the balance below zero is rejected with insufficient_balance before it runs.
Auto-recharge: Opt-in, off by default. You set the trigger balance, the top-up amount, and optional daily and weekly caps in the dashboard. Nothing else recurs.
Free grant: ~500 pages free on signup. No card. Claimed in the dashboard. Password signups verify their email first, with the link emailed at sign-up.
Payments and tax: Card payments are processed by Dodo Payments as Merchant of Record. Where prices are shown tax-inclusive, your receipt and wallet show what you paid and what was credited, with the page count it equals.
Published rate: The per-page price is published in the dashboard and echoed in wallet and job API responses.
Refunds: The refund policy is section 6 of the terms of service.