Skip to content
Beautiful accounting software


Tax Rates

URL https://api.xero.com/api.xro/2.0/TaxRates
Methods Supported GET
Description Returns tax rates for a Xero organisation

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)

Response elements returned for GET Tax Rates

Name Name of Tax rate
TaxType See Tax Types
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
EffectiveTaxRate Effective Tax Rate (decimal to 4dp) e.g 12.5000

Example response for GET TaxRates

<TaxRates>
  <TaxRate>
    <Name>GST on Expenses</Name>
    <TaxType>INPUT</TaxType>
    <CanApplyToAssets>true</CanApplyToAssets>
    <CanApplyToEquity>true</CanApplyToEquity>
    <CanApplyToExpenses>true</CanApplyToExpenses>
    <CanApplyToLiabilities>true</CanApplyToLiabilities>
    <CanApplyToRevenue>false</CanApplyToRevenue>
    <DisplayTaxRate>12.5000</DisplayTaxRate>
    <EffectiveRate>12.5000</EffectiveRate>
  </TaxRate>
  <TaxRate>
    <Name>GST on Income</Name>
    <TaxType>OUTPUT</TaxType>
    <CanApplyToAssets>true</CanApplyToAssets>
    <CanApplyToEquity>true</CanApplyToEquity>
    <CanApplyToExpenses>false</CanApplyToExpenses>
    <CanApplyToLiabilities>true</CanApplyToLiabilities>
    <CanApplyToRevenue>true</CanApplyToRevenue>
    <DisplayTaxRate>12.5000</DisplayTaxRate>
    <EffectiveRate>12.5000</EffectiveRate>
  </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>
  </TaxRate>
  <TaxRate>
    <Name>Zero Rated</Name>
    <TaxType>ZERORATED</TaxType>
    <CanApplyToAssets>false</CanApplyToAssets>
    <CanApplyToEquity>false</CanApplyToEquity>
    <CanApplyToExpenses>false</CanApplyToExpenses>
    <CanApplyToLiabilities>false</CanApplyToLiabilities>
    <CanApplyToRevenue>true</CanApplyToRevenue>
    <DisplayTaxRate>0.0000</DisplayTaxRate>
    <EffectiveRate>0.0000</EffectiveRate>
  </TaxRate>
</TaxRates>