Taxpayers
List and retrieve taxpayers
List everything under your organisation, or fetch a single taxpayer by id.
GET
/v1/api/taxpayersFiltered and paginated, same envelope shape as List transactions:
{ docs, total_docs, limit, offset } under data. Ordered by name, with the id as a tiebreak so a
page boundary stays stable across requests.
| Field | Type | Description | |
|---|---|---|---|
| search | string | optional | Case-insensitive substring match against name, vat_id or cr_number |
| peppol_status | enum | optional | not_registered · registered · failed · removed |
| limit | integer | optional | 1–100, default 10 |
| offset | integer | optional | Default 0 |
total_docs counts the filtered set, not the page — keep paging until you've seen that many, not until
a page comes back short.
GET /v1/api/taxpayers/{taxpayer_id} returns a single taxpayer in the same shape as
Onboard a taxpayer's response, and PATCH on the same path updates any
writable field.