ark_list_quickbooks_reference_data

ark.list_quickbooks_reference_data

List QuickBooks accounts, customers, custom fields, payment accounts, items, terms, tax codes, or vendors for ARK accounting setup, mapping, and sync troubleshooting.

Availability: Expanded preview
Scopes: billing:read
ARK permissions: canViewBilling
Team visibility: Not entity-scoped
Approval policy: none
ARK approval request: Not required
Idempotency: Not required
Read-only: Yes
Destructive: No
External side effect: Yes
Rate limit: OAuth MCP credential and organization budgets

Input

resourcestringrequired

QuickBooks reference data to fetch. Use customers/vendors for manual entity mapping and payment_accounts for bank and other-current-asset accounts used in payment routing.

one of: accounts, customers, custom_fields, payment_accounts, items, terms, tax_codes, vendors

searchstring

Optional QuickBooks display-name, name, SKU, or account-number search.

min length: 1; max length: 100

maxResultsinteger

default: 100; min: 1; max: 1000

accountTypestring

Optional QuickBooks AccountType filter for resource=accounts.

max length: 100

classificationstring

Optional QuickBooks Classification filter for resource=accounts.

max length: 100

categorystring

Use vendor_expense to list Expense and Cost of Goods Sold accounts.

one of: vendor_expense

itemTypestring

Optional QuickBooks item Type filter for resource=items.

one of: Service, Inventory, NonInventory

includeConfigboolean

When resource=payment_accounts, include the configured default payment account ID.

default: false

accountUsagestring

Which default payment account config to return when includeConfig is true.

one of: carrier, customer; default: "carrier"

The tool returns the canonical ark.list_quickbooks_reference_data operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.