Search QuickBooks accounts | Distru Documentation

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
limit	integer	No	Default: `10`
cursor	string	No	nextCursor of the previous call; keep the other arguments unchanged.
ids	string[]	No	QuickBooks account IDs.
search	string	No	Case-insensitive substring or fuzzy word match on the full name ("Parent:Child"), so a parent's name also finds its sub-accounts. Ranks by similarity, replacing sortBy.
accountTypes	enum[] 14 values `ACCOUNTS_PAYABLEACCOUNTS_RECEIVABLEBANKCOST_OF_GOODS_SOLDCREDIT_CARDEQUITYEXPENSEFIXED_ASSETINCOMELONG_TERM_LIABILITYOTHER_CURRENT_ASSETOTHER_CURRENT_LIABILITYOTHER_EXPENSEOTHER_INCOME`	No	Any of these QuickBooks account types.
status	enum `ACTIVEANYINACTIVE`	No	Default ACTIVE.
sortBy	object	No	Default UPDATED_AT DESC. Ignored while search is set.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `INSERTED_ATNAMEUPDATED_AT`	Yes	NAME = full name; INSERTED_AT / UPDATED_AT = when the account was created / last changed in QuickBooks.

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence
hasMore	boolean	Always
nextCursor	string	Can be absent
totalCount	integer	Can be absent
items	object[]	Always
items[].id	string	Always
items[].name	string	Always
items[].accountType	string	Always
items[].active	boolean	Always

What the AI reads

Searches QuickBooks' own accounts: Distru's copy of the connected QuickBooks company's chart of accounts, refreshed about every 15 minutes, without the accounts QuickBooks deleted. Unlike distru-search-quickbooks-items, which returns Distru's item mappings and the accounts each item posts to, these are QuickBooks records. Use it rather than another QuickBooks connector for an account Distru works with: Distru's write tools take an account by full name (distru-create-invoice-payment's qbDepositAccount), and Distru's settings and items point at one by its QuickBooks id. id is that QuickBooks id; name is the full name ("Parent:Child" for a sub-account). accountType is QuickBooks' own type name.