---
title: "Updates tax rates"
method: POST
path: "/TaxRates"
tags: ["Accounting"]
---

# Updates tax rates

`POST /TaxRates`

## Headers

- `Idempotency-Key` string

## Request body

- TaxRates
  - `TaxRates` TaxRate[]
    - `Name` string — Name of tax rate
    - `TaxType` string — The tax type
    - `TaxComponents` TaxComponent[] — See TaxComponents
      - `Name` string — Name of Tax Component
      - `Rate` number, double — Tax Rate (up to 4dp)
      - `IsCompound` boolean — Boolean to describe if Tax rate is compounded.
      - `IsNonRecoverable` boolean — Boolean to describe if tax rate is non-recoverable. Non-recoverable rates are only applicable to Canadian organisations
    - `Status` 'ACTIVE' | 'DELETED' | 'ARCHIVED' | 'PENDING' — See Status Codes
    - `ReportTaxType` 'AVALARA' | 'BASEXCLUDED' | 'CAPITALSALESOUTPUT' | 'CAPITALEXPENSESINPUT' | 'ECOUTPUT' | 'ECOUTPUTSERVICES' | 'ECINPUT' | 'ECACQUISITIONS' | 'EXEMPTEXPENSES' | 'EXEMPTINPUT' | 'EXEMPTOUTPUT' | 'GSTONIMPORTS' | 'INPUT' | 'INPUTTAXED' | 'MOSSSALES' | 'NONE' | 'NONEOUTPUT' | 'OUTPUT' | 'PURCHASESINPUT' | 'SALESOUTPUT' | 'EXEMPTCAPITAL' | 'EXEMPTEXPORT' | 'CAPITALEXINPUT' | 'GSTONCAPIMPORTS' | 'GSTONCAPITALIMPORTS' | 'REVERSECHARGES' | 'PAYMENTS' | 'INVOICE' | 'CASH' | 'ACCRUAL' | 'FLATRATECASH' | 'FLATRATEACCRUAL' | 'ACCRUALS' | 'TXCA' | 'SRCAS' | 'DSOUTPUT' | 'BLINPUT2' | 'EPINPUT' | 'IMINPUT2' | 'MEINPUT' | 'IGDSINPUT2' | 'ESN33OUTPUT' | 'OPINPUT' | 'OSOUTPUT' | 'TXN33INPUT' | 'TXESSINPUT' | 'TXREINPUT' | 'TXPETINPUT' | 'NRINPUT' | 'ES33OUTPUT' | 'ZERORATEDINPUT' | 'ZERORATEDOUTPUT' | 'DRCHARGESUPPLY' | 'DRCHARGE' | 'CAPINPUT' | 'CAPIMPORTS' | 'IMINPUT' | 'INPUT2' | 'CIUINPUT' | 'SRINPUT' | 'OUTPUT2' | 'SROUTPUT' | 'CAPOUTPUT' | 'SROUTPUT2' | 'CIUOUTPUT' | 'ZROUTPUT' | 'ZREXPORT' | 'ACC28PLUS' | 'ACCUPTO28' | 'OTHEROUTPUT' | 'SHOUTPUT' | 'ZRINPUT' | 'BADDEBT' | 'OTHERINPUT' | 'BADDEBTRELIEF' | 'IGDSINPUT3' | 'SROVR' | 'TOURISTREFUND' | 'TXRCN33' | 'TXRCRE' | 'TXRCESS' | 'TXRCTS' | 'CAPEXINPUT' | 'UNDEFINED' | 'CAPEXOUTPUT' | 'ZEROEXPOUTPUT' | 'GOODSIMPORT' | 'NONEINPUT' | 'NOTREPORTED' | 'SROVRRS' | 'SROVRLVG' | 'SRLVG' | 'IM' | 'IMESS' | 'IMN33' | 'IMRE' | 'BADDEBTRECOVERY' | 'USSALESTAX' | 'BLINPUT3' — See ReportTaxTypes
    - `CanApplyToAssets` boolean — Boolean to describe if tax rate can be used for asset accounts i.e. true,false
    - `CanApplyToEquity` boolean — Boolean to describe if tax rate can be used for equity accounts i.e true,false
    - `CanApplyToExpenses` boolean — Boolean to describe if tax rate can be used for expense accounts i.e. true,false
    - `CanApplyToLiabilities` boolean — Boolean to describe if tax rate can be used for liability accounts i.e. true,false
    - `CanApplyToRevenue` boolean — Boolean to describe if tax rate can be used for revenue accounts i.e. true,false
    - `DisplayTaxRate` number, double — Tax Rate (decimal to 4dp) e.g 12.5000
    - `EffectiveRate` number, double — Effective Tax Rate (decimal to 4dp) e.g 12.5000

## Response `200`

Success - return response of type TaxRates array updated TaxRate

- TaxRates
  - `TaxRates` TaxRate[]
    - `Name` string — Name of tax rate
    - `TaxType` string — The tax type
    - `TaxComponents` TaxComponent[] — See TaxComponents
      - `Name` string — Name of Tax Component
      - `Rate` number, double — Tax Rate (up to 4dp)
      - `IsCompound` boolean — Boolean to describe if Tax rate is compounded.
      - `IsNonRecoverable` boolean — Boolean to describe if tax rate is non-recoverable. Non-recoverable rates are only applicable to Canadian organisations
    - `Status` 'ACTIVE' | 'DELETED' | 'ARCHIVED' | 'PENDING' — See Status Codes
    - `ReportTaxType` 'AVALARA' | 'BASEXCLUDED' | 'CAPITALSALESOUTPUT' | 'CAPITALEXPENSESINPUT' | 'ECOUTPUT' | 'ECOUTPUTSERVICES' | 'ECINPUT' | 'ECACQUISITIONS' | 'EXEMPTEXPENSES' | 'EXEMPTINPUT' | 'EXEMPTOUTPUT' | 'GSTONIMPORTS' | 'INPUT' | 'INPUTTAXED' | 'MOSSSALES' | 'NONE' | 'NONEOUTPUT' | 'OUTPUT' | 'PURCHASESINPUT' | 'SALESOUTPUT' | 'EXEMPTCAPITAL' | 'EXEMPTEXPORT' | 'CAPITALEXINPUT' | 'GSTONCAPIMPORTS' | 'GSTONCAPITALIMPORTS' | 'REVERSECHARGES' | 'PAYMENTS' | 'INVOICE' | 'CASH' | 'ACCRUAL' | 'FLATRATECASH' | 'FLATRATEACCRUAL' | 'ACCRUALS' | 'TXCA' | 'SRCAS' | 'DSOUTPUT' | 'BLINPUT2' | 'EPINPUT' | 'IMINPUT2' | 'MEINPUT' | 'IGDSINPUT2' | 'ESN33OUTPUT' | 'OPINPUT' | 'OSOUTPUT' | 'TXN33INPUT' | 'TXESSINPUT' | 'TXREINPUT' | 'TXPETINPUT' | 'NRINPUT' | 'ES33OUTPUT' | 'ZERORATEDINPUT' | 'ZERORATEDOUTPUT' | 'DRCHARGESUPPLY' | 'DRCHARGE' | 'CAPINPUT' | 'CAPIMPORTS' | 'IMINPUT' | 'INPUT2' | 'CIUINPUT' | 'SRINPUT' | 'OUTPUT2' | 'SROUTPUT' | 'CAPOUTPUT' | 'SROUTPUT2' | 'CIUOUTPUT' | 'ZROUTPUT' | 'ZREXPORT' | 'ACC28PLUS' | 'ACCUPTO28' | 'OTHEROUTPUT' | 'SHOUTPUT' | 'ZRINPUT' | 'BADDEBT' | 'OTHERINPUT' | 'BADDEBTRELIEF' | 'IGDSINPUT3' | 'SROVR' | 'TOURISTREFUND' | 'TXRCN33' | 'TXRCRE' | 'TXRCESS' | 'TXRCTS' | 'CAPEXINPUT' | 'UNDEFINED' | 'CAPEXOUTPUT' | 'ZEROEXPOUTPUT' | 'GOODSIMPORT' | 'NONEINPUT' | 'NOTREPORTED' | 'SROVRRS' | 'SROVRLVG' | 'SRLVG' | 'IM' | 'IMESS' | 'IMN33' | 'IMRE' | 'BADDEBTRECOVERY' | 'USSALESTAX' | 'BLINPUT3' — See ReportTaxTypes
    - `CanApplyToAssets` boolean — Boolean to describe if tax rate can be used for asset accounts i.e. true,false
    - `CanApplyToEquity` boolean — Boolean to describe if tax rate can be used for equity accounts i.e true,false
    - `CanApplyToExpenses` boolean — Boolean to describe if tax rate can be used for expense accounts i.e. true,false
    - `CanApplyToLiabilities` boolean — Boolean to describe if tax rate can be used for liability accounts i.e. true,false
    - `CanApplyToRevenue` boolean — Boolean to describe if tax rate can be used for revenue accounts i.e. true,false
    - `DisplayTaxRate` number, double — Tax Rate (decimal to 4dp) e.g 12.5000
    - `EffectiveRate` number, double — Effective Tax Rate (decimal to 4dp) e.g 12.5000

## Other responses

- `400` — A failed request due to validation error

---

[API](https://skmtc.net/xeroapi/apis/xero-accounting-api.md) · [All operations](https://skmtc.net/xeroapi/apis/xero-accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xeroapi/xero-accounting-api/versions/dc231cafd8de/schema)