BRbrex-com
Accounting VAT

Update tax code

Changed on

Apply per-subsidiary status changes (partial-apply; unlisted subsidiaries unchanged). Name and rate are immutable.

patch/v3/accounting/integration/{integration_id}/tax-codes/{brex_id}

Request

Path parameters

brex_idstring required
integration_idstring required

Headers

Idempotency-Keystring

Caller-generated key (recommend a v4 UUID) that uniquely identifies this logical request. Reuse the same value when retrying so the request is de-duplicated.

Request body

Example request

{
  "subsidiaries": [
    {
      "status": "ENABLED",
      "subsidiary_id": "sub_uk_ltd"
    }
  ]
}

Response

Tax code updated

brex_idstring required

The internal Brex ID of the tax code

namestring required

Human-readable name of the tax code

ratenumber nullable

Tax rate as a percentage (e.g. 20 for 20%). 0 is zero-rated; null is exempt

remote_idstring nullable

The tax code's identifier in the remote accounting system. Null when the caller did not provide one.

updated_atstring date-time required

The last updated timestamp of the tax code

Example response

{
  "brex_id": "tc_abc123",
  "name": "UK Standard",
  "rate": 20,
  "remote_id": "remote-tax-uk-vat-20",
  "subsidiaries": [
    {
      "status": "ENABLED",
      "subsidiary_id": "sub_uk_ltd",
      "subsidiary_name": "UK Ltd"
    }
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}

Changes