Tax Rates


Overview

URL https://api.xero.com/api.xro/2.0/TaxRates
Methods Supported GET, PUT
Description Returns tax rates for a Xero organisation
Allows you to add new tax rates for a Xero organisation

Elements for Tax Rates

Name Name of Tax rate
TaxType See Tax Types
TaxComponents See TaxComponents
The following element is required only for AU, NZ & UK based organisations.
Note – US and Global versions do not support the ReportTaxType element.
ReportTaxType See ReportTaxTypes
The following elements are only returned on a GET request
Status The Status of the Tax Rate e.g. ACTIVE, DELETED
CanApplyToAssets Boolean to describe if tax rate can be used for asset accounts i.e. true,false
CanApplyToEquity Boolean to describe if tax rate can be used for equity accounts i.e. true,false
CanApplyToExpenses Boolean to describe if tax rate can be used for expense accounts i.e. true,false
CanApplyToLiabilities Boolean to describe if tax rate can be used for liability accounts i.e. true,false
CanApplyToRevenue Boolean to describe if tax rate can be used for revenue accounts i.e. true,false
DisplayTaxRate Tax Rate (decimal to 4dp) e.g 12.5000
EffectiveRate Effective Tax Rate (decimal to 4dp) e.g 12.5000

Elements for TaxComponents

Name Name of Tax Component
Rate Tax Rate (up to 4dp)
IsCompound Boolean to describe if Tax rate is compounded.Learn more

PUT TaxRates

Use this method to create new tax rates.

Current limitations

  • You can only add tax rates one at a time (i.e. you’ll need to do multiple API calls to add many tax rates
  • Updating tax rates is not currently supported via the Xero API.

Example for PUT Tax Rates

Below is an example of creating a tax rate in the US with the minimum elements required to add a new tax rate of 8.125% for Oakdale, CA

<TaxRate>
  <Name>Oakdale Sales Tax</Name>
  <TaxComponents>
    <TaxComponent>
      <Name>State Tax</Name>
      <Rate>7.5</Rate>
      <IsCompound>false</IsCompound>
    </TaxComponent>
     <TaxComponent>
      <Name>Local Sales Tax</Name>
      <Rate>0.625</Rate>
      <IsCompound>false</IsCompound>
    </TaxComponent>
  </TaxComponents>
</TaxRate>

GET TaxRates

Optional parameters for GET TaxRates

TaxType Filter by a Tax Type
Where Filter by an any element (see Filters)
order Order by any element returned (see Order By)

Example response for GET TaxRates

<TaxRates>
    <TaxRate>
     <Name>15% GST on Expenses</Name>
     <TaxType>INPUT2</TaxType>
     <CanApplyToAssets>true</CanApplyToAssets>
     <CanApplyToEquity>true</CanApplyToEquity>
     <CanApplyToExpenses>true</CanApplyToExpenses>
     <CanApplyToLiabilities>true</CanApplyToLiabilities>
     <CanApplyToRevenue>false</CanApplyToRevenue>
     <DisplayTaxRate>15.0000</DisplayTaxRate>
     <EffectiveRate>15.0000</EffectiveRate>
     <Status>ACTIVE</Status>
     <TaxComponents>
       <TaxComponent>
         <Name>GST</Name>
         <Rate>15.0000</Rate>
         <IsCompound>false</IsCompound>
       </TaxComponent>
     </TaxComponents>
   </TaxRate>
   <TaxRate>
     <Name>15% GST on Income</Name>
     <TaxType>OUTPUT2</TaxType>
     <CanApplyToAssets>true</CanApplyToAssets>
     <CanApplyToEquity>true</CanApplyToEquity>
     <CanApplyToExpenses>false</CanApplyToExpenses>
     <CanApplyToLiabilities>true</CanApplyToLiabilities>
     <CanApplyToRevenue>true</CanApplyToRevenue>
     <DisplayTaxRate>15.0000</DisplayTaxRate>
     <EffectiveRate>15.0000</EffectiveRate>
     <Status>ACTIVE</Status>
     <TaxComponents>
       <TaxComponent>
         <Name>GST</Name>
         <Rate>15.0000</Rate>
         <IsCompound>false</IsCompound>
       </TaxComponent>
     </TaxComponents>
   </TaxRate>
   <TaxRate>
     <Name>GST on Imports</Name>
     <TaxType>GSTONIMPORTS</TaxType>
     <CanApplyToAssets>false</CanApplyToAssets>
     <CanApplyToEquity>false</CanApplyToEquity>
     <CanApplyToExpenses>false</CanApplyToExpenses>
     <CanApplyToLiabilities>true</CanApplyToLiabilities>
     <CanApplyToRevenue>false</CanApplyToRevenue>
     <DisplayTaxRate>0.0000</DisplayTaxRate>
     <EffectiveRate>0.0000</EffectiveRate>
     <Status>ACTIVE</Status>
     <TaxComponents>
       <TaxComponent>
         <Name>GST</Name>
         <Rate>0.0000</Rate>
         <IsCompound>false</IsCompound>
       </TaxComponent>
     </TaxComponents>
   </TaxRate>
   <TaxRate>
     <Name>No GST</Name>
     <TaxType>NONE</TaxType>
     <CanApplyToAssets>true</CanApplyToAssets>
     <CanApplyToEquity>true</CanApplyToEquity>
     <CanApplyToExpenses>true</CanApplyToExpenses>
     <CanApplyToLiabilities>true</CanApplyToLiabilities>
     <CanApplyToRevenue>true</CanApplyToRevenue>
     <DisplayTaxRate>0.0000</DisplayTaxRate>
     <EffectiveRate>0.0000</EffectiveRate>
     <Status>ACTIVE</Status>
     <TaxComponents>
       <TaxComponent>
         <Name>GST</Name>
         <Rate>0.0000</Rate>
         <IsCompound>false</IsCompound>
       </TaxComponent>
     </TaxComponents>
   </TaxRate>
   <TaxRate>
     <Name>Zero Rated</Name>
     <TaxType>ZERORATED</TaxType>
     <CanApplyToAssets>false</CanApplyToAssets>
     <CanApplyToEquity>false</CanApplyToEquity>
     <CanApplyToExpenses>false</CanApplyToExpenses>
     <CanApplyToLiabilities>true</CanApplyToLiabilities>
     <CanApplyToRevenue>true</CanApplyToRevenue>
     <DisplayTaxRate>0.0000</DisplayTaxRate>
     <EffectiveRate>0.0000</EffectiveRate>
     <Status>ACTIVE</Status>
     <TaxComponents>
       <TaxComponent>
         <Name>GST</Name>
         <Rate>0.0000</Rate>
         <IsCompound>false</IsCompound>
       </TaxComponent>
     </TaxComponents>
   </TaxRate>
</TaxRates>