# Limits

> File size, concurrency, parse duration and the monthly document cap.

Section: API reference
Source: https://statementbear.com/docs/api/limits
Product: StatementBear statement parsing API, $0.49 per document, 25 free.

---

Four limits. There is no per-minute rate limit and no burst quota.

| Limit | Value | Response |
| --- | --- | --- |
| File size | 20MB | `413 file_too_large` |
| Concurrent documents | 4 per organisation | `429 too_many_concurrent_requests` |
| Documents per calendar month | Set per organisation | `402 monthly_cap_reached` |
| Replay storage | 24 hours, about 1MB per response | `409 idempotency_key_not_replayable` |

## Concurrency

Four documents may be in flight at once per organisation. There is no per-minute quota, so four in the air continuously runs all day and a queue of ten thousand statements is a matter of time.

> **Ask if you need more**
>
> The limit keeps one customer's burst from slowing everybody else down. It will never be tightened below four, and we will raise it if your workload needs the headroom.

## The monthly cap

Every organisation has a document 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 window rolls on your next request, so there is nothing to wait for at the start of a month. Errors do not count against it. Only documents that returned `200`.

## Parse duration

10 to 40 seconds, depending on how many rows the statement holds. A long multi-month statement takes proportionally longer. Set a client timeout of at least 180 seconds.

## Errors are free

None of these responses are billable, and none of them spend the monthly cap.

| Status | Code | Description |
| --- | --- | --- |
| 402 | `trial_exhausted` | The free allowance is spent and no card is on file. Add a payment method in the console and the same key keeps working. Nothing needs redeploying. |
| 402 | `monthly_cap_reached` | Your monthly document ceiling was hit. There is nothing to buy. Tell us your volume and we raise it. |
| 402 | `canceled` | Billing for this account was cancelled. Contact us to reactivate. Keys are kept, so nothing needs reissuing. |
| 413 | `file_too_large` | Over 20MB. Refused as soon as the size is known. Split the statement or export a smaller range. |
| 429 | `too_many_concurrent_requests` | More than 4 documents in flight at once. A limit on documents in flight at once. There is no per-minute limit. Wait a couple of seconds and retry with the same idempotency key. |

---

All documentation: https://statementbear.com/docs/llms.txt
Questions: api@statementbear.com