List accounts

GET/v1/operations/accounts.list

The organisation's chart of accounts from QuickBooks: each account's name, full name (parent:child), number, type and whether it is active. Use search to narrow it (matches name, full name or number). Use it to find the exact account before asking for an account's transactions.

Scope: synced.read · reads only
Roles: Super admin, Admin, Submitter, Custom (by default; an admin can change this per operation)
MCP tool: accounts_list

Request

Send the token as Authorization: Bearer. A token approved for several organisations also sends Synced-Organisation: {id} (see Organisations).

Query parameters

Name	Type	Description
`search`	string	SearchWords from the account's name or full name, or its number.
`includeInactive`	boolean	Include inactive default `false`

Response

200 with a JSON body. 401 without a valid token, 403 when the scope, role or organisation does not allow it, 429 when rate limited (see Errors and limits).

Name	Type	Description
`count`	integer
`accounts`	object[]
`id`	string
`name`	string
`fullName`	string
`number`	string
`type`	string
`classification`	string
`active`	boolean
`parentId`	string

Example

curl -X GET 'https://api.syncedhq.com/v1/operations/accounts.list' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Try it

Sign in to send this request as yourself. You choose the organisations on Synced's consent screen; the token stays in this tab and expires within an hour.

searchstring

Words from the account's name or full name, or its number.

includeInactiveboolean

Request

curl -X GET 'https://api.syncedhq.com/v1/operations/accounts.list' \
  -H 'Accept: application/json'

Response

Sign in, then send the request.