Pagination
Every list endpoint is paginated with the same two query parameters:
The response wraps the page:
Filters
- Filters are query parameters (
?origin=peppol,?type=company, …). Each list endpoint documents its own set in the API reference. - Enumeration filters accept a comma-separated list treated as a logical OR:
?origin=manual,peppol,mail. - An unknown filter value returns
400 invalid_filterwith the allowed values in the message.
Retrieving all your data
offset is capped at 10000 — a service protection: paginating very deep by offset
is expensive. The cap does not prevent a full retrieval:
- Documents — the only high-volume resource: slice by date windows with
issue_date_from/issue_date_to(one year at a time, for example) and paginate within each window.totaltells you when a window needs narrowing. - Other resources stay far below the cap (a few bank accounts, journals or delivery locations per company).