Manage your organization's tax profile and access EU VAT rates. The tax profile stores your legal entity details (VAT ID, tax regime, legal address) used on invoices and for reverse-charge determination.
EU VAT rates are maintained automatically and include standard, reduced, super-reduced, and parking rates for all EU member states.
List EU VAT rates
Returns all current EU-27 VAT rates including standard, reduced, and super-reduced rates.
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
List EU VAT rates › Responses
OK
Get organization tax profile
Returns the organization's tax profile including legal name, address, VAT ID, and tax regime.
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Get organization tax profile › Responses
OK
Update organization tax profile
Updates the organization's tax profile fields (partial update supported).
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Update organization tax profile › Request Body
bank_account_namebank_bicbank_ibaninvoice_contact_emailinvoice_contact_nameinvoice_contact_phonelegal_nameoss_countrypeppol_idregister_courtregister_numbersmall_business_schemetax_numbertax_regimevat_idUpdate organization tax profile › Responses
OK
List declarable tax-registration schemes
The scheme picker's options, optionally filtered by country. Each option says what the registration covers and what it does not — VOEC is consumer-only, and an operator has to be told so at the moment of picking it.
query Parameters
countryISO 3166-1 alpha-2. Omit for every country the registry knows a register for.
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
List declarable tax-registration schemes › Responses
OK
Declare or amend a tax registration
Declares one of the organization's own registrations, or amends the one that starts on the same date. A new start date creates a successor rather than replacing the earlier row.
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Declare or amend a tax registration › Request Body
countryISO 3166-1 alpha-2 of the state the registration is HELD IN, which is not always the organization's own country.
identifierThe number as issued, e.g. GB999999973, CHE-123.456.789 MWST.
schemeScheme identifier out of the closed set the jurisdiction registry owns.
evidence_refWhat proves it: a VIES check id, an HMRC consultation number, an uploaded certificate's document id, or an operator's note.
valid_fromYYYY-MM-DD. Defaults to today. It is part of the row's identity: a number reissued after a deregistration is a NEW registration with a new start date, and the old row survives so an invoice issued under it can still say so.
valid_toYYYY-MM-DD, or null for an open-ended registration.
Declare or amend a tax registration › Responses
OK
Record a deregistration
Closes the registration's open validity window. It is never deleted: a registration that was live when an invoice was issued is a fact about that invoice forever, and the resolver reads the window on the document's own tax point.
Headers
Idempotency-KeyUnique key that makes this POST safe to retry: repeats with the same key replay the first response instead of re-executing. Replays are scoped to the retrying principal (same API key / user) and kept for 24 hours. Required on every POST.
Client-generated idempotency key (e.g. a UUID).
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Record a deregistration › Request Body
countryschemevalid_toYYYY-MM-DD, the last day the registration was in force. Defaults to today.
Record a deregistration › Responses
OK
Export tax data
Exports tax data for a billing period as CSV or JSON. Includes invoice line items with tax breakdowns.
query Parameters
fromPeriod start date (YYYY-MM-DD)
toPeriod end date (YYYY-MM-DD, inclusive)
formatOutput format: csv or json (default csv)
jurisdictionFilter by jurisdiction country code
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
Export tax data › Responses
Tax export file (CSV or JSON)