| URL | https://api.xero.com/api.xro/2.0/Organisation |
| Methods Supported | GET |
| Description | Returns information about a Xero 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. . |
| Edition | BUSINESS or PARTNER. Partner edition organisations are sold exclusively through accounting partners and have restricted functionality (e.g. no access to invoicing) . |
| Class | Organisation Classes describe which plan the Xero organisation is on (e.g. DEMO, TRIAL, PREMIUM). |
| 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. http://twitter.com/xeroapi |
Example response for GET Organisation
GET https://api.xero.com/api.xro/2.0/Organisations
To verify if an organisation is using contruction industry scheme, you can retrieve the CIS settings for the organistaion.
To retrieve CIS details, you have to do a GET request with OrganisationID and need to additionally specify CISettings in your url. Refer to the request and response sample.
| The following is returned for the CIS settings of an Organisation | |
| CISContractorEnabled | true or false - Boolean that describes if the organisation is a CIS Contractor |
| CISSubContractorEnabled | true or false - Boolean that describes if the organisation is a CIS SubContractor |
Example of retrieving CIS settings for an organisation
GET https://api.xero.com/api.xro/2.0/Organisation/bd2270c3-8706-4c11-9cfb-000b551c3f51/CISSettings
