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.

KindCapCounted over
Chart of accounts300 accountsThe whole chart
Invoices1,000 per monthThe month the request states
Bills1,000 per monthThe month the request states
Lines in one invoice or bill100Each document
Journal lines1,000 per monthThe month the request states
Operational data1,000 rows per monthThe 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.