---
title: "List tax groups"
method: GET
path: "/v3/accounting/integration/{integration_id}/tax-groups"
tags: ["Accounting VAT"]
---

# List tax groups

`GET /v3/accounting/integration/{integration_id}/tax-groups`

## Request

- Base URL: `https://api.brex.com`
- URL: `https://api.brex.com/v3/accounting/integration/{integration_id}/tax-groups`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://accounts-api.brex.com/oauth2/default/v1/authorize`
    - Token URL: `https://accounts-api.brex.com/oauth2/default/v1/token` scopes: `accounting.integration.read`, `accounting.integration.write`
- TypeScript: <https://skmtc.dev/brex-com/apis/accounting-api/docs/v3/accounting/integration/:integration_id/tax-groups/get.ts> (a function with typed inputs; its response is checked against the schema)

List tax groups for the active integration. Each group includes its member tax codes and per-subsidiary enablement.

## Path parameters

- `integration_id` string, required

## Query parameters

- `cursor` string
- `limit` number
- `status` 'ENABLED' | 'DISABLED'
- `subsidiary_id` string

## Response `200`

Tax groups listed successfully

- TaxGroupPaginatedResponse
  - `items` TaxGroup[], required: The items in the response
    - `brex_id` string, required: The internal Brex ID of the tax group
    - `name` string, required: Human-readable name of the tax group
    - `subsidiaries` TaxSubsidiary[], required: Per-subsidiary enablement, one entry per subsidiary with a setting for this group
      - `status` 'ENABLED' | 'DISABLED', required: Whether the code/group is enabled for this subsidiary
      - `subsidiary_id` string, required: The internal Brex ID of the subsidiary
      - `subsidiary_name` string, required: Human-readable name of the subsidiary
    - `tax_codes` TaxGroupTaxCode[], required: The member tax codes contained in this group
      - `brex_id` string, required: The internal Brex ID of the member tax code
      - `name` string, required: Human-readable name of the member tax code
      - `rate` number, nullable: Tax rate as a percentage (e.g. 20 for 20%). 0 is zero-rated; null is exempt
      - `updated_at` string, date-time, required: The last updated timestamp of the member tax code
    - `updated_at` string, date-time, required: The last updated timestamp of the tax group
  - `next_cursor` string, nullable, required: The next cursor

## Other responses

- `400`: The request is invalid.
- `401`: The bearer token is missing or rejected.
- `403`: The token does not have a required scope.

## Changes

- **2026-11-06** `abca76caa09d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brex-com/apis/accounting-api/changes/v3/accounting/integration/:integration_id/tax-groups/get.md)

---

[API](https://skmtc.dev/brex-com/apis/accounting-api.md) - [All operations](https://skmtc.dev/brex-com/apis/accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brex-com/apis/accounting-api/revisions/abca76caa09d?raw)