Methods Supported GET
Description Returns information about a Xero organisation

GET Organisation

The following elements are returned in a response

APIKey Display a unique key used for Xero-to-Xero transactions
Name Display name of organisation shown in Xero
LegalName Organisation name shown on Reports
PaysTax Boolean to describe if organisation is registered with a local tax authority i.e. true, false
Version See Version Types
OrganisationType Organisation Type
BaseCurrency Default currency for organisation. See ISO 4217 Currency Codes
CountryCode Country code for organisation. See ISO 3166-2 Country Codes
IsDemoCompany Boolean to describe if organisation is a demo company.
OrganisationStatus Will be set to ACTIVE if you can connect to organisation via the Xero API
RegistrationNumber Shows for New Zealand, Australian and UK organisations
EmployerIdentificationNumber Shown if set. US Only.
TaxNumber Shown if set. Displays in the Xero UI as Tax File Number (AU), GST Number (NZ), VAT Number (UK) and Tax ID Number (US & Global).
FinancialYearEndDay Calendar day e.g. 0-31
FinancialYearEndMonth Calendar Month e.g. 1-12
SalesTaxBasis The accounting basis used for tax returns. See Sales Tax Basis
SalesTaxPeriod The frequency with which tax returns are processed. See Sales Tax Period
DefaultSalesTax The default for LineAmountTypes on sales transactions
DefaultPurchasesTax The default for LineAmountTypes on purchase transactions
PeriodLockDate Shown if set. See lock dates
EndOfYearLockDate Shown if set. See lock dates
CreatedDateUTC Timestamp when the organisation was created in Xero
Timezone Timezone specifications
OrganisationEntityType Organisation Type
ShortCode A unique identifier for the organisation. Used in a number of potential use cases such as deep linking.
OrganisationID The Xero generated unique identifier for the organisation. .
LineOfBusiness Description of business type as defined in Organisation settings
Addresses Address details for organisation - see Addresses
Phones Phones details for organisation - see Phones
ExternalLinks Organisation profile links for popular services such as Facebook, Twitter, GooglePlus and LinkedIn. You can also add link to your website here. Shown if Organisation settings is updated in Xero. See ExternalLinks below
PaymentTerms Default payment terms for the organisation if set - See Payment Terms below

Elements for PaymentTerms

Bills Default payment terms for bills (accounts payable)
Sales Default payment terms for sales invoices (accounts receivable)

Elements for Bills and Sales

Day Day of Month (0-31)
Type The type of payment term - see Payment Terms

Elements for ExternalLinks

LinkType See External link types
Url URL for service e.g.

Example response for GET Organisation

   <Name>Demo Company (NZ)</Name>
   <LegalName>Demo Company (NZ)</LegalName>
       <AddressLine1>3 Market Place</AddressLine1>
       <AddressLine2>Twizel 7901</AddressLine2>
       <Country>New Zealand</Country>
       <AttentionTo>Bentley Rhythm Ace</AttentionTo>