Moneybird API

Tax rates

Endpointhttps://moneybird.com/api/v2

Tax rates are the VAT tariffs that apply to your products and services.

List all available tax rates for the administration

GET

https://moneybird.com/api/v2

/{administration_id}/tax_rates{format}

Returns a paginated list of all available tax rates for the administration

The filter argument allows you to filter the list of tax rates. Filters are a combination of keys and values, separated by a comma: percentage:21,tax_rate_type:sales_invoice. The available options for filtering are:

Filter	Type	Default	Description
name	`String`		Select tax rates by their full name
partial_name	`String`		Select tax rates with this substring in their name
percentage	`Integer`		Select tax rates with the specified percentage, e.g. specify `21` for 21%
tax_rate_type	`String`	`all`	`all`, `general_journal_document`, `purchase_invoice` or `sales_invoice`
country	`String`		Select tax rates with the specified country. Must be a 2 letter abbreviation following ISO 3166. Please note that only foreign tax rates will have this field set. Domestic tax rates will not have this set at the moment.
show_tax	`Boolean`		Use `true` to tax rates for which tax is shown on the invoice, `false` for when it's not shown. No value will select both
active	`Boolean`		Use `true` to select active tax rates. Use `false` for inactive tax rates. No value will select both
created_after	`String`		Tax rates created after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone
updated_after	`String`		Tax rates updated after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone

You can filter by multiple tax rate types at the same time as well. To do this, separate the state values by a pipe: state:purchase_invoice|sales_invoice.

List all available tax rates for the administration › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all available tax rates for the administration › query Parameters

filter

string

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

List all available tax rates for the administration › Responses

A list of tax rates

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

tax_rate_type

string · enum

Enum values:

sales_invoice

purchase_invoice

general_journal_document

show_tax

boolean | null

active

boolean | null

country

string | null

created_at

string | null · date-time

updated_at

string | null · date-time

GET/{administration_id}/tax_rates{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/tax_rates:format

shell

Example Responses

[
  {
    "id": "471699736823334023",
    "administration_id": 123,
    "name": "21% btw",
    "percentage": "21.0",
    "tax_rate_type": "sales_invoice",
    "show_tax": true,
    "active": true,
    "country": null,
    "created_at": "2025-11-25T10:52:25.782Z",
    "updated_at": "2025-11-25T10:52:25.782Z"
  },
  {
    "id": "471699736831722632",
    "administration_id": 123,
    "name": "9% btw",
    "percentage": "9.0",
    "tax_rate_type": "sales_invoice",
    "show_tax": true,
    "active": true,
    "country": null,
    "created_at": "2025-11-25T10:52:25.792Z",
    "updated_at": "2025-11-25T10:52:25.792Z"
  },
  {
    "id": "471699736833819785",
    "administration_id": 123,
    "name": "0% btw",
    "percentage": "0.0",
    "tax_rate_type": "sales_invoice",
    "show_tax": true,
    "active": true,
    "country": null,
    "created_at": "2025-11-25T10:52:25.794Z",
    "updated_at": "2025-11-25T10:52:25.794Z"
  },
  {
    "id": "471699736836965514",
    "administration_id": 123,
    "name": "21% btw",
    "percentage": "21.0",
    "tax_rate_type": "purchase_invoice",
    "show_tax": true,
    "active": true,
    "country": null,
    "created_at": "2025-11-25T10:52:25.797Z",
    "updated_at": "2025-11-25T10:52:25.797Z"
  },
  {
    "id": "471699736842208395",
    "administration_id": 123,
    "name": "9% btw",
    "percentage": "9.0",
    "tax_rate_type": "purchase_invoice",
    "show_tax": true,
    "active": true,
    "country": null,
    "created_at": "2025-11-25T10:52:25.802Z",
    "updated_at": "2025-11-25T10:52:25.802Z"
  }
]

json

application/json

Subscriptions Time entries

List all available tax rates for the administration

GET

https://moneybird.com/api/v2

/{administration_id}/tax_rates{format}

Returns a paginated list of all available tax rates for the administration

Filter	Type	Default	Description
name	`String`		Select tax rates by their full name
partial_name	`String`		Select tax rates with this substring in their name
percentage	`Integer`		Select tax rates with the specified percentage, e.g. specify `21` for 21%
tax_rate_type	`String`	`all`	`all`, `general_journal_document`, `purchase_invoice` or `sales_invoice`
country	`String`		Select tax rates with the specified country. Must be a 2 letter abbreviation following ISO 3166. Please note that only foreign tax rates will have this field set. Domestic tax rates will not have this set at the moment.
show_tax	`Boolean`		Use `true` to tax rates for which tax is shown on the invoice, `false` for when it's not shown. No value will select both
active	`Boolean`		Use `true` to select active tax rates. Use `false` for inactive tax rates. No value will select both
created_after	`String`		Tax rates created after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone
updated_after	`String`		Tax rates updated after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone

You can filter by multiple tax rate types at the same time as well. To do this, separate the state values by a pipe: state:purchase_invoice|sales_invoice.

List all available tax rates for the administration › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all available tax rates for the administration › query Parameters

filter

string

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

List all available tax rates for the administration › Responses

A list of tax rates

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

name

string

tax_rate_type

string · enum

Enum values:

sales_invoice

purchase_invoice

general_journal_document

show_tax

boolean | null

active

boolean | null

country

string | null

created_at

string | null · date-time

updated_at

string | null · date-time

[ { "id": "471699736823334023", "administration_id": 123, "name": "21% btw", "percentage": "21.0", "tax_rate_type": "sales_invoice", "show_tax": true, "active": true, "country": null, "created_at": "2025-11-25T10:52:25.782Z", "updated_at": "2025-11-25T10:52:25.782Z" }, { "id": "471699736831722632", "administration_id": 123, "name": "9% btw", "percentage": "9.0", "tax_rate_type": "sales_invoice", "show_tax": true, "active": true, "country": null, "created_at": "2025-11-25T10:52:25.792Z", "updated_at": "2025-11-25T10:52:25.792Z" }, { "id": "471699736833819785", "administration_id": 123, "name": "0% btw", "percentage": "0.0", "tax_rate_type": "sales_invoice", "show_tax": true, "active": true, "country": null, "created_at": "2025-11-25T10:52:25.794Z", "updated_at": "2025-11-25T10:52:25.794Z" }, { "id": "471699736836965514", "administration_id": 123, "name": "21% btw", "percentage": "21.0", "tax_rate_type": "purchase_invoice", "show_tax": true, "active": true, "country": null, "created_at": "2025-11-25T10:52:25.797Z", "updated_at": "2025-11-25T10:52:25.797Z" }, { "id": "471699736842208395", "administration_id": 123, "name": "9% btw", "percentage": "9.0", "tax_rate_type": "purchase_invoice", "show_tax": true, "active": true, "country": null, "created_at": "2025-11-25T10:52:25.802Z", "updated_at": "2025-11-25T10:52:25.802Z" } ]