List Tax Codes - Thredfi Partner API

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
    }
  ]
}

Field	Type	Description
`code`	string	Canonical tax code to send on invoice line items
`name`	string	Display name in the chart language when available
`rate`	number	Tax rate as a decimal fraction, for example `0.21` for 21%
`purchase_account`	string or null	Input-tax GL account code when configured
`sales_account`	string or null	Output-tax GL account code when configured
`effective_from`	string or null	Effective date from the tax template
`is_active`	boolean	Whether 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.