---
title: "Update a tax rate"
method: PATCH
path: "/accounting_tax_rates/{tax_rate_id}"
tags: ["Accounting tax rates"]
---

# Update a tax rate

`PATCH /accounting_tax_rates/{tax_rate_id}`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/accounting_tax_rates/{tax_rate_id}`
- Auth: HTTP bearer

Update an existing tax rate account

## Path parameters

- `tax_rate_id` string, required

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `code` string: Code for the tax rate from the accounting platform
  - `description` string: Description of the tax rate
  - `effective_tax_rate` integer: Effective tax rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
  - `name` string: Name of the tax rate

## Response `200`

Successful Response

- AccountingTaxRateResponse
  - `id` string, uuid, required
  - `created_at` string, date-time, required: The timestamp when the tax rate was created.
  - `updated_at` string, date-time, required: The timestamp when the tax rate was last updated.
  - `code` string: Code for the tax rate from the accounting platform.
  - `components` TaxComponentResponse[]
    - `is_compound` boolean: A flag to indicate with the tax is calculated using the principle of compounding.
    - `name` string
    - `rate` integer: Component tax rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
  - `description` string: Description of the tax rate
  - `effective_tax_rate` integer: Effective tax rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
  - `is_external` boolean: Whether the tax rate is from an external system
  - `name` string
  - `status` string
  - `total_tax_rate` integer: Total (not compounded) sum of the components of a tax rate in [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Business logic error
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/monite/apis/monite-3.md) - [All operations](https://skmtc.dev/monite/apis/monite-3/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-3/revisions/c13be6f83ce9?raw)