Caps per company
Six caps bound what one company may hold through the API, whatever credential sent the request. They size the feeds an installation accepts, so a whole chart or a whole trading month is not handed over in one call.
| Kind | Cap | Counted over |
|---|---|---|
| Chart of accounts | 300 accounts | The whole chart |
| Invoices | 1,000 per month | The month the request states |
| Bills | 1,000 per month | The month the request states |
| Lines in one invoice or bill | 100 | Each document |
| Journal lines | 1,000 per month | The month the request states |
| Operational data | 1,000 rows per month | The month the request states |
The test is what the company holds once the request has landed, not how many records arrive: the documents already stored for that month are counted together with the ones in the payload, and sending the same documents again does not count them twice - so a company at its cap can still correct what it sent. A payload that replaces stored rows with new ones keeps the old ones counted until the next request: the cap errs towards refusing.
A request that would leave the company over one of those caps is refused whole, before anything is written:
HTTP/1.1 422 Unprocessable Content
{
"message": "The request was refused.",
"errors": [
{
"field": "records",
"code": "cap_exceeded",
"detail": "This company may hold at most 1000 invoices for Sep-2026; this request would leave 1002."
}
]
}
A document carrying more lines than the line cap is refused on its own: the response is still
202, that invoice or bill is counted in counts.rejected, and the rest of the
payload is written. The refusal of each record is read back from the request's results:
document_lines_exceeded. A refused document is not one of the documents the request wrote,
so under replace_period or replace_all an earlier copy this source held is
removed with it - send the corrected document, not only the long one.
The caps are installation settings
Each one is a setting - API_CAP_ACCOUNTS,
API_CAP_INVOICES_PER_MONTH, API_CAP_BILLS_PER_MONTH,
API_CAP_DOCUMENT_LINES, API_CAP_JOURNAL_LINES_PER_MONTH and
API_CAP_OPERATION_ROWS_PER_MONTH - with 0 lifting that cap. The schema endpoint
states the figures in force under caps.
The per-request limits, the group's per-minute allowance and the one-write rule are on Limits.