--- title: "Retrieves Xero organisation details" method: GET path: "/Organisation" tags: ["Accounting"] --- # Retrieves Xero organisation details `GET /Organisation` ## Response `200` Success - return response of type Organisation array with all Organisation - Organisations - `Organisations` Organisation[] - `OrganisationID` string, uuid — Unique Xero identifier - `APIKey` string — Display a unique key used for Xero-to-Xero transactions - `Name` string — Display name of organisation shown in Xero - `LegalName` string — Organisation name shown on Reports - `PaysTax` boolean — Boolean to describe if organisation is registered with a local tax authority i.e. true, false - `Version` 'AU' | 'NZ' | 'GLOBAL' | 'UK' | 'US' | 'AUONRAMP' | 'NZONRAMP' | 'GLOBALONRAMP' | 'UKONRAMP' | 'USONRAMP' — See Version Types - `OrganisationType` 'ACCOUNTING_PRACTICE' | 'COMPANY' | 'CHARITY' | 'CLUB_OR_SOCIETY' | 'INDIVIDUAL' | 'LOOK_THROUGH_COMPANY' | 'NOT_FOR_PROFIT' | 'PARTNERSHIP' | 'S_CORPORATION' | 'SELF_MANAGED_SUPERANNUATION_FUND' | 'SOLE_TRADER' | 'SUPERANNUATION_FUND' | 'TRUST' | 'PERSONAL' | 'SINGLEMEMBERLLC' | 'CCORPORATIONLLC' | 'PARTNERSHIPLLC' | 'SCORPORATIONLLC' | 'LLC' | 'NOTLLC' | 'UNSPECIFIED' — Organisation Type - `BaseCurrency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BYR' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EEK' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LTL' | 'LVL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRO' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SKK' | 'SLE' | 'SLL' | 'SOS' | 'SRD' | 'STD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZMK' | 'ZWD' — 3 letter alpha code for the currency – see list of currency codes - `CountryCode` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GQ' | 'GR' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' - `IsDemoCompany` boolean — Boolean to describe if organisation is a demo company. - `OrganisationStatus` string — Will be set to ACTIVE if you can connect to organisation via the Xero API - `RegistrationNumber` string — Shows for New Zealand, Australian and UK organisations - `EmployerIdentificationNumber` string — Shown if set. US Only. - `TaxNumber` string — 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` integer — Calendar day e.g. 0-31 - `FinancialYearEndMonth` integer — Calendar Month e.g. 1-12 - `SalesTaxBasis` 'PAYMENTS' | 'INVOICE' | 'NONE' | 'CASH' | 'ACCRUAL' | 'FLATRATECASH' | 'FLATRATEACCRUAL' | 'ACCRUALS' — The accounting basis used for tax returns. See Sales Tax Basis - `SalesTaxPeriod` 'MONTHLY' | 'QUARTERLY1' | 'QUARTERLY2' | 'QUARTERLY3' | 'ANNUALLY' | 'ONEMONTHS' | 'TWOMONTHS' | 'SIXMONTHS' | '1MONTHLY' | '2MONTHLY' | '3MONTHLY' | '6MONTHLY' | 'QUARTERLY' | 'YEARLY' | 'NONE' — The frequency with which tax returns are processed. See Sales Tax Period - `DefaultSalesTax` string — The default for LineAmountTypes on sales transactions - `DefaultPurchasesTax` string — The default for LineAmountTypes on purchase transactions - `PeriodLockDate` string — Shown if set. See lock dates - `EndOfYearLockDate` string — Shown if set. See lock dates - `CreatedDateUTC` string — Timestamp when the organisation was created in Xero - `Timezone` 'AFGHANISTANSTANDARDTIME' | 'ALASKANSTANDARDTIME' | 'ALEUTIANSTANDARDTIME' | 'ALTAISTANDARDTIME' | 'ARABIANSTANDARDTIME' | 'ARABICSTANDARDTIME' | 'ARABSTANDARDTIME' | 'ARGENTINASTANDARDTIME' | 'ASTRAKHANSTANDARDTIME' | 'ATLANTICSTANDARDTIME' | 'AUSCENTRALSTANDARDTIME' | 'AUSCENTRALWSTANDARDTIME' | 'AUSEASTERNSTANDARDTIME' | 'AZERBAIJANSTANDARDTIME' | 'AZORESSTANDARDTIME' | 'BAHIASTANDARDTIME' | 'BANGLADESHSTANDARDTIME' | 'BELARUSSTANDARDTIME' | 'BOUGAINVILLESTANDARDTIME' | 'CANADACENTRALSTANDARDTIME' | 'CAPEVERDESTANDARDTIME' | 'CAUCASUSSTANDARDTIME' | 'CENAUSTRALIASTANDARDTIME' | 'CENTRALAMERICASTANDARDTIME' | 'CENTRALASIASTANDARDTIME' | 'CENTRALBRAZILIANSTANDARDTIME' | 'CENTRALEUROPEANSTANDARDTIME' | 'CENTRALEUROPESTANDARDTIME' | 'CENTRALPACIFICSTANDARDTIME' | 'CENTRALSTANDARDTIME' | 'CENTRALSTANDARDTIME(MEXICO)' | 'CHATHAMISLANDSSTANDARDTIME' | 'CHINASTANDARDTIME' | 'CUBASTANDARDTIME' | 'DATELINESTANDARDTIME' | 'EAFRICASTANDARDTIME' | 'EASTERISLANDSTANDARDTIME' | 'EASTERNSTANDARDTIME' | 'EASTERNSTANDARDTIME(MEXICO)' | 'EAUSTRALIASTANDARDTIME' | 'EEUROPESTANDARDTIME' | 'EGYPTSTANDARDTIME' | 'EKATERINBURGSTANDARDTIME' | 'ESOUTHAMERICASTANDARDTIME' | 'FIJISTANDARDTIME' | 'FLESTANDARDTIME' | 'GEORGIANSTANDARDTIME' | 'GMTSTANDARDTIME' | 'GREENLANDSTANDARDTIME' | 'GREENWICHSTANDARDTIME' | 'GTBSTANDARDTIME' | 'HAITISTANDARDTIME' | 'HAWAIIANSTANDARDTIME' | 'INDIASTANDARDTIME' | 'IRANSTANDARDTIME' | 'ISRAELSTANDARDTIME' | 'JORDANSTANDARDTIME' | 'KALININGRADSTANDARDTIME' | 'KAMCHATKASTANDARDTIME' | 'KOREASTANDARDTIME' | 'LIBYASTANDARDTIME' | 'LINEISLANDSSTANDARDTIME' | 'LORDHOWESTANDARDTIME' | 'MAGADANSTANDARDTIME' | 'MAGALLANESSTANDARDTIME' | 'MARQUESASSTANDARDTIME' | 'MAURITIUSSTANDARDTIME' | 'MIDATLANTICSTANDARDTIME' | 'MIDDLEEASTSTANDARDTIME' | 'MONTEVIDEOSTANDARDTIME' | 'MOROCCOSTANDARDTIME' | 'MOUNTAINSTANDARDTIME' | 'MOUNTAINSTANDARDTIME(MEXICO)' | 'MYANMARSTANDARDTIME' | 'NAMIBIASTANDARDTIME' | 'NCENTRALASIASTANDARDTIME' | 'NEPALSTANDARDTIME' | 'NEWFOUNDLANDSTANDARDTIME' | 'NEWZEALANDSTANDARDTIME' | 'NORFOLKSTANDARDTIME' | 'NORTHASIAEASTSTANDARDTIME' | 'NORTHASIASTANDARDTIME' | 'NORTHKOREASTANDARDTIME' | 'OMSKSTANDARDTIME' | 'PACIFICSASTANDARDTIME' | 'PACIFICSTANDARDTIME' | 'PACIFICSTANDARDTIME(MEXICO)' | 'PAKISTANSTANDARDTIME' | 'PARAGUAYSTANDARDTIME' | 'QYZYLORDASTANDARDTIME' | 'ROMANCESTANDARDTIME' | 'RUSSIANSTANDARDTIME' | 'RUSSIATIMEZONE10' | 'RUSSIATIMEZONE11' | 'RUSSIATIMEZONE3' | 'SAEASTERNSTANDARDTIME' | 'SAINTPIERRESTANDARDTIME' | 'SAKHALINSTANDARDTIME' | 'SAMOASTANDARDTIME' | 'SAOTOMESTANDARDTIME' | 'SAPACIFICSTANDARDTIME' | 'SARATOVSTANDARDTIME' | 'SAWESTERNSTANDARDTIME' | 'SEASIASTANDARDTIME' | 'SINGAPORESTANDARDTIME' | 'SOUTHAFRICASTANDARDTIME' | 'SOUTHSUDANSTANDARDTIME' | 'SRILANKASTANDARDTIME' | 'SUDANSTANDARDTIME' | 'SYRIASTANDARDTIME' | 'TAIPEISTANDARDTIME' | 'TASMANIASTANDARDTIME' | 'TOCANTINSSTANDARDTIME' | 'TOKYOSTANDARDTIME' | 'TOMSKSTANDARDTIME' | 'TONGASTANDARDTIME' | 'TRANSBAIKALSTANDARDTIME' | 'TURKEYSTANDARDTIME' | 'TURKSANDCAICOSSTANDARDTIME' | 'ULAANBAATARSTANDARDTIME' | 'USEASTERNSTANDARDTIME' | 'USMOUNTAINSTANDARDTIME' | 'UTC' | 'UTC+12' | 'UTC+13' | 'UTC02' | 'UTC08' | 'UTC09' | 'UTC11' | 'VENEZUELASTANDARDTIME' | 'VLADIVOSTOKSTANDARDTIME' | 'VOLGOGRADSTANDARDTIME' | 'WAUSTRALIASTANDARDTIME' | 'WCENTRALAFRICASTANDARDTIME' | 'WESTASIASTANDARDTIME' | 'WESTBANKSTANDARDTIME' | 'WESTPACIFICSTANDARDTIME' | 'WEUROPESTANDARDTIME' | 'WMONGOLIASTANDARDTIME' | 'YAKUTSKSTANDARDTIME' | 'YUKONSTANDARDTIME' — Timezone specifications - `OrganisationEntityType` 'ACCOUNTING_PRACTICE' | 'COMPANY' | 'CHARITY' | 'CLUB_OR_SOCIETY' | 'INDIVIDUAL' | 'LOOK_THROUGH_COMPANY' | 'NOT_FOR_PROFIT' | 'PARTNERSHIP' | 'S_CORPORATION' | 'SELF_MANAGED_SUPERANNUATION_FUND' | 'SOLE_TRADER' | 'SUPERANNUATION_FUND' | 'TRUST' | 'PERSONAL' | 'SINGLEMEMBERLLC' | 'CCORPORATIONLLC' | 'PARTNERSHIPLLC' | 'SCORPORATIONLLC' | 'LLC' | 'NOTLLC' | 'UNSPECIFIED' — Organisation Entity Type - `ShortCode` string — A unique identifier for the organisation. Potential uses. - `Class` 'DEMO' | 'TRIAL' | 'STARTER' | 'STANDARD' | 'PREMIUM' | 'PREMIUM_20' | 'PREMIUM_50' | 'PREMIUM_100' | 'LEDGER' | 'GST_CASHBOOK' | 'NON_GST_CASHBOOK' | 'ULTIMATE' | 'LITE' | 'ULTIMATE_10' | 'ULTIMATE_20' | 'ULTIMATE_50' | 'ULTIMATE_100' | 'IGNITE' | 'GROW' | 'COMPREHENSIVE' | 'SIMPLE' | 'BASICLITE' | 'ULTRA' — Organisation Classes describe which plan the Xero organisation is on (e.g. DEMO, TRIAL, PREMIUM) - `Edition` 'BUSINESS' | 'PARTNER' — BUSINESS or PARTNER. Partner edition organisations are sold exclusively through accounting partners and have restricted functionality (e.g. no access to invoicing) - `LineOfBusiness` string — Description of business type as defined in Organisation settings - `Addresses` AddressForOrganisation[] — Address details for organisation – see Addresses - `AddressType` 'POBOX' | 'STREET' | 'DELIVERY' — define the type of address - `AddressLine1` string — max length = 500 - `AddressLine2` string — max length = 500 - `AddressLine3` string — max length = 500 - `AddressLine4` string — max length = 500 - `City` string — max length = 255 - `Region` string — max length = 255 - `PostalCode` string — max length = 50 - `Country` string — max length = 50, [A-Z], [a-z] only - `AttentionTo` string — max length = 255 - `Phones` Phone[] — Phones details for organisation – see Phones - `PhoneType` 'DEFAULT' | 'DDI' | 'MOBILE' | 'FAX' | 'OFFICE' - `PhoneNumber` string — max length = 50 - `PhoneAreaCode` string — max length = 10 - `PhoneCountryCode` string — max length = 20 - `ExternalLinks` ExternalLink[] — 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 - `LinkType` 'Facebook' | 'GooglePlus' | 'LinkedIn' | 'Twitter' | 'Website' — See External link types - `Url` string — URL for service e.g. http://twitter.com/xeroapi - `Description` string - `PaymentTerms` PaymentTerm - `Bills` Bill - `Day` integer — Day of Month (0-31) - `Type` 'DAYSAFTERBILLDATE' | 'DAYSAFTERBILLMONTH' | 'OFCURRENTMONTH' | 'OFFOLLOWINGMONTH' - `Sales` Bill - `Day` integer — Day of Month (0-31) - `Type` 'DAYSAFTERBILLDATE' | 'DAYSAFTERBILLMONTH' | 'OFCURRENTMONTH' | 'OFFOLLOWINGMONTH' --- [API](https://skmtc.net/xeroapi/apis/xero-accounting-api.md) · [All operations](https://skmtc.net/xeroapi/apis/xero-accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xeroapi/xero-accounting-api/versions/dc231cafd8de/schema)