Get Account (V2)
GET/api/xero/v2/accounts/:account
Detail view-model for a single Xero account (chart of accounts) — backs the /v2/integrations/xero/accounts/{id} detail page. Returns the stored generated columns, descriptive fields that only live in the raw Xero json_object payload, the linked SKU nominal code, and local sync metadata.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Authentication: Requires Bearer token.
Path parameters:
- account (required, integer): xero_accounts.id
nominal_code is the SKU nominal code this account links to (null when unlinked). link_basis records how the link was resolved: mapping = an explicit polymorphic mapping (set by the onboarding wizard / QBO), code = inferred by matching xero_accounts.Code ⇄ nominal_codes.code (the fallback Xero's sync uses when a tenant adopted its chart). The frontend deep-links from here to /v2/ledger/accounts/{nominal_code.id}.
Xero accounts are config records: there is no remote deep-link, no line items and no per-record sync status, so those are intentionally omitted.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.