Lists and syncing

Every list is paged and ordered from the oldest change, so it can be synced reliably.

Paging

Parameter	Meaning
`page`	Page number from 1.
`pageSize`	Records on a page, 1–100 (50 by default).
`updatedSince`	Only records changed after this time.
`q`	Text in the name, number, IČO or e-mail.

{
  "items": [ … ],
  "page": 1,
  "pageSize": 50,
  "total": 132
}

Document filters

`kind`	Kind of an issued document (`invoice`, `proforma`, …).
`issuedFrom`, `issuedTo`	Issue date from–to (inclusive).
`paid`	`true` paid, `false` with an amount due.
`companyNumber`	IČO of the customer (issued) or the supplier (received).

GET /api/v1/invoices?kind=invoice&paid=false&issuedFrom=2026-10-01&pageSize=100

Syncing

Keep the updatedAt of the last processed record and next time ask only for newer changes:

GET /api/v1/invoices?updatedSince=2026-10-26T08:30:00Z&page=1&pageSize=100

Go through the pages until you get fewer records than pageSize. Deleted documents are not in the list; webhooks tell you about them (invoice.deleted).