Retrieves a single chart of accounts by using a unique account Id
GET/Accounts/{AccountID}
Use it in a workflow
Add a step and choose the Xero connector.
Pick the Get Account action (under Xero).
Fill in the fields below, then reference the result from later steps as {{getAccount.response.data}}.
Request
Path parameters
AccountIDstring (uuid)required
Unique identifier for Account object
Headers
xero-tenant-idstringrequired
Xero identifier for Tenant
Response
Returns 200 with an object. Read it in later steps with {{getAccount.response.data.<field>}}.
Accountsarray<object>
Codestring
Customer defined alpha numeric account code e.g 200 or SALES (max length = 10)
Namestring
Name of account (max length = 150)
AccountIDstring (uuid)
The Xero identifier for an account – specified as a string following the endpoint name e.g. /297c2dc5-cc47-4afd-8ec8-74990b8761e9
Typestring
See Account Types
One ofBANKCURRENTCURRLIABDEPRECIATNDIRECTCOSTSEQUITYEXPENSEFIXEDINVENTORYLIABILITYNONCURRENTOTHERINCOMEOVERHEADSPREPAYMENTREVENUESALESTERMLIABPAYG
BankAccountNumberstring
For bank accounts only (Account Type BANK)
Statusstring
Accounts with a status of ACTIVE can be updated to ARCHIVED. See Account Status Codes
One ofACTIVEARCHIVEDDELETED
Descriptionstring
Description of the Account. Valid for all types of accounts except bank accounts (max length = 4000)
BankAccountTypestring
For bank accounts only. See Bank Account types
One ofBANKCREDITCARDPAYPALNONE
CurrencyCodestring
3 letter alpha code for the currency – see list of currency codes
One ofAEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBWPBYNBYRBZDCADCDFCHFCLFCLPCNYCOPCRCCUCCUPCVECZKDJFDKK
TaxTypestring
The tax type from taxRates
EnablePaymentsToAccountboolean
Boolean – describes whether account can have payments applied to it
ShowInExpenseClaimsboolean
Boolean – describes whether account code is available for use with expense claims
Classstring
See Account Class Types
One ofASSETEQUITYEXPENSELIABILITYREVENUE
SystemAccountstring
If this is a system account then this element is returned. See System Account types. Note that non-system accounts may have this element set as either “” or null.
One ofDEBTORSCREDITORSBANKCURRENCYGAINGSTGSTONIMPORTSHISTORICALREALISEDCURRENCYGAINRETAINEDEARNINGSROUNDINGTRACKINGTRANSFERSUNPAIDEXPCLMUNREALISEDCURRENCYGAINWAGEPAYABLESCISASSETSCISASSETCISLABOURCISLABOUREXPENSECISLABOURINCOMECISLIABILITYCISMATERIALS
ReportingCodestring
Shown if set
ReportingCodeNamestring
Shown if set
HasAttachmentsboolean
boolean to indicate if an account has an attachment (read only)
Default "false"
UpdatedDateUTCstring
Last modified date UTC format
AddToWatchlistboolean
Boolean – describes whether the account is shown in the watchlist widget on the dashboard
ValidationErrorsarray<object>1 fields
Displays array of validation error messages from the API
