Moneybird logo
Moneybird API

Tax rates

Endpoint:https://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:

FilterTypeDefaultDescription
nameStringSelect tax rates by their full name
partial_nameStringSelect tax rates with this substring in their name
percentageIntegerSelect tax rates with the specified percentage, e.g. specify 21 for 21%
tax_rate_typeStringallall, general_journal_document, purchase_invoice or sales_invoice
countryStringSelect 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_taxBooleanUse true to tax rates for which tax is shown on the invoice, false for when it's not shown. No value will select both
activeBooleanUse true to select active tax rates. Use false for inactive tax rates. No value will select both
created_afterStringTax rates created after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone
updated_afterStringTax 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 administrationpath Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • formatstring · 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 administrationquery Parameters

  • filterstring
  • per_pageinteger | string · min: 1 · max: 100 · pattern: ^\d+$

List all available tax rates for the administrationResponses

A list of tax rates

  • idstring | integer · pattern: ^\d+$

    A unique record identifier

  • administration_idstring | integer · pattern: ^\d+$

    A unique record identifier of an administration

  • namestring
  • percentage
  • tax_rate_typestring · enum
    Enum values:
    sales_invoice
    purchase_invoice
    general_journal_document
  • show_taxboolean | null
  • activeboolean | null
  • countrystring | null
  • created_atstring | null · date-time
  • updated_atstring | null · date-time