> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thredfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tax Codes

> List active structured tax/VAT codes for a business

```http theme={null}
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

```json theme={null}
{
  "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

```json theme={null}
{
  "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`.