Skip to main content
GET /v1/platform/businesses/{business_id}/tax-codes/
Returns the active tax codes configured for the business’s primary chart of accounts. Use these codes on invoice line items with tax_code or sales_taxes[].code.

​
Authentication

Use either a partner token scoped to the owning partner or a business-scoped token for the same business_id.

​
Response

{
  "business_id": "964f4325-3efb-400d-a1bd-8b1f29e828cf",
  "count": 2,
  "tax_codes": [
    {
      "code": "BTW_21",
      "name": "VAT 21% (Standard)",
      "rate": 0.21,
      "purchase_account": "1520",
      "sales_account": "2100",
      "effective_from": "2024-01-01",
      "is_active": true
    },
    {
      "code": "EXEMPT",
      "name": "VAT Exempt",
      "rate": 0,
      "purchase_account": null,
      "sales_account": null,
      "effective_from": "2024-01-01",
      "is_active": true
    }
  ]
}
FieldTypeDescription
codestringCanonical tax code to send on invoice line items
namestringDisplay name in the chart language when available
ratenumberTax rate as a decimal fraction, for example 0.21 for 21%
purchase_accountstring or nullInput-tax GL account code when configured
sales_accountstring or nullOutput-tax GL account code when configured
effective_fromstring or nullEffective date from the tax template
is_activebooleanWhether the tax code can currently be used

​
Invoice Usage

{
  "line_items": [
    {
      "description": "Consulting services",
      "quantity": 1,
      "unit_price": 10000,
      "tax_code": "BTW_21"
    }
  ]
}
Unknown codes are rejected with a 4xx validation error. For tax-exempt customers, use an exempt or zero-rated code such as EXEMPT.