Skip to content
 


TYPES AND CODES

Below is a detailed list of all the types and codes the Xero API uses:

Accounts

Account Class Types

ASSET
EQUITY
EXPENSE
LIABILITY
REVENUE

Account Types

BANK
CURRENT
CURRLIAB
DEPRECIATN
DIRECTCOSTS
EQUITY
EXPENSE
FIXED
LIABILITY
NONCURRENT
OTHERINCOME
OVERHEADS
PREPAYMENT
REVENUE
SALES
TERMLIAB

Account Status Codes

ACTIVE
ARCHIVED

System Accounts

Accounts Receivable (610)
Accounts Payable (800)
Bank Revaluations(497)
GST(820)
GST On Imports (821)
Historical Adjustment (840)
Realised Currency Gains (499)
Retained Earnings (960)
Rounding (860)
Tracking Transfers (877)
Unpaid Expense Claims (801)
Unrealised Currency Gains (498)

Bank Transactions

Types

RECEIVE
SPEND

Bank Transaction Status Codes

ACTIVE
DELETED

Contacts

Contact Status Codes

ACTIVE
The following value is only supported via the GET method
DELETED

Credit Notes

Credit Note Types

ACCPAYCREDIT An Accounts Payable(supplier) Credit Note
ACCRECCREDIT An Account Receivable(customer) Credit Note

All other types are identical to Invoices.

Addresses

Addresses

AddressType
AddressLine 1,2,3,4
City
Region
PostalCode
Country
AttentionTo

Address Types

POBOX (default mailing address for Invoices)
STREET

Phones

Phones

PhoneType
PhoneNumber
PhoneAreaCode
PhoneCountryCode

Phone Types

DEFAULT
DDI
MOBILE
FAX

Invoices

Invoice Types

ACCPAY An Accounts Payable(supplier) invoice
ACCREC An Account Receivable(customer) invoice

Invoice Status Codes

DRAFT A Draft Invoice (default)
SUBMITTED An Awaiting Approval Invoice
DELETED A Deleted Invoice
AUTHORISED An Invoice that is Approved and Awaiting Payment
PAID An Invoice that is completely Paid
VOIDED A Voided Invoice

LineAmount Types

Exclusive Invoice lines are exclusive of tax (default)
Inclusive Invoice lines are inclusive tax
NoTax Invoices lines have no tax

LineItems

Tax Types

New Zealand

TAX TYPE RATE  
INPUT 12.50 GST on Expenses (old rate)
INPUT2 15.00 GST on Expenses
NONE 0.00 No GST
OUTPUT 12.50 GST on Income (old rate)
OUTPUT2 15.00 GST on Income

United Kingdom

TAX TYPE RATE  
CAPEXINPUT 17.50 VAT on Capital Purchases
CAPEXOUTPUT 17.50 VAT on Capital Sales
CAPEXINPUT2 20.00 VAT on Capital Purchases (new rate from 4 Jan 2011)
CAPEXOUTPUT2 20.00 VAT on Capital Sales (new rate from 4 Jan 2011)
ECZRINPUT 0.00 Zero Rated EC Expenses
ECZROUTPUT 0.00 Zero Rated EC Income
EXEMPTINPUT 0.00 Exempt Expenses
EXEMPTOUTPUT 0.00 Exempt Income
INPUT 17.50 VAT on Expenses
INPUT2 20.00 VAT on Expenses (new rate from 4 Jan 2011)
NONE 0.00 No VAT
OUTPUT 17.50 VAT on Income
OUTPUT2 20.0 VAT on Income (new rate from 4 Jan 2011)
RRINPUT 5.00 5% (VAT on Expenses)
RROUTPUT 5.00 5% (VAT on Income)
SRINPUT 15.00 VAT on Expenses(old rate)
SROUTPUT 15.00 VAT on Income(old rate)
ZERORATEDINPUT 0.00 Zero Rated Expenses
ZERORATEDOUTPUT 0.00 Zero Rated Income

Australia

TAX TYPE RATE  
CAPEXINPUT 10.00 GST on Capital
EXEMPTEXPORT 0.00 GST Free Exports
EXEMPTINPUT 0.00 GST Exempt
EXEMPTOUTPUT 0.00 GST Free Income
INPUT 10.00 GST on Expenses
INPUTTAXED 0.00 Input Taxed
NONE 0.00 No GST
OUTPUT 10.00 GST on Income

Global

TAX TYPE RATE  
INPUT 0.00 Tax on Purchases
NONE 0.00 Tax Exempt
OUTPUT 0.00 Tax on Sales
GSTONIMPORTS 0.00 Sales Tax on Imports

United States

TAX TYPE RATE  
INPUT 9.2500 Tax on Purchases
NONE 0.00 Tax Exempt
OUTPUT 9.2500 Tax on Sales
GSTONIMPORTS 0.00 Sales Tax on Imports

New tax rates can be setup for a Xero organisation. All new tax rates added have a TaxType of the format TAX001, TAX002 etc.

Manual Journals

Manual Journal Status Codes

DRAFT A Draft ManualJournal (default)
POSTED A Posted ManualJournal
DELETED A Deleted Draft ManualJournal
VOIDED A Voided Posted ManualJournal

Organisation

Version Types

AU Business editions
NZ
GLOBAL
UK
US
AUONRAMP Partner & Cashbook editions. NOTE: Authorization on Cashbook edition has to approved by partners
NZONRAMP
GLOBALONRAMP
UKONRAMP
USONRAMP

Organisation Types

COMPANY
CHARITY
CLUBSOCIETY
PARTNERSHIP
PERSON
SOLETRADER
TRUST

User Roles

Xero User Roles

READONLY Read only user – Further info
INVOICEONLY Invoice only user – Further info
STANDARD Standard user – Further info
FINANCIALADVISER Financial adviser role – Further info
MANAGEDCLIENT Managed client role (Partner Edition only) – Further info
CASHBOOKCLIENT Cashbook client role (Partner Edition only) – Further info