List Accounts (V2)

GET 
/api/xero/v2/accounts

Paginated list of Xero accounts with advanced filtering via Spatie QueryBuilder + GroupedFilterSupport.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Authentication: Requires Bearer token.

Query Parameters:

• page (optional, integer, default 1): Page number
• per_page (optional, integer, default 15): Records per page
• sort (optional, string): Allowed sorts: id, Name, Code, Type, Status, Class, created_at. Default: Name
• filter[search] (optional, string): Search across id, Name, Code

Advanced Filters (filter_groups): Supports all operators: is, is_not, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty, is_one_of (text fields); greater_than, less_than, between (numeric). Filterable columns: id (numeric), Name (text), Code (text), Type (text), Class (text), Status (text)

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

429

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.