List Accounts
GET/api/qbo/accounts
Paginated list of QBO accounts with filtering and sorting. Defaults to active accounts only.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Searchable columns (filter[search]): id, qbo_id, name, acct_num, fully_qualified_name, account_sub_type.
Mapping health (filter[mapping_status]): linked = a nominal code is explicitly mapped to the account; name_match = no explicit mapping, but a nominal code with the exact same name exists (matched by name at push time); unmapped = neither. Each row includes nominal_code (the explicitly mapped nominal code, null when not mapped) and mapping_status.
Request
Responses
- 200
- 401
- 403
- 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.
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.