MCP documentation | MCP docs for agents

ark_list_quickbooks_sync_jobs

ark.list_quickbooks_sync_jobs

List visible ARK QuickBooks sync jobs with operation, status, retryability, active-sync count, and per-item error context for accounting workflow monitoring.

Availability
Expanded preview
Scopes
loads:readbilling:read
ARK permissions
canViewLoadscanViewBilling
Team visibility
Required and enforced
Approval policy
none
ARK approval request
Not required
Idempotency
Not required
Read-only
Yes
Destructive
No
External side effect
No
Rate limit
OAuth MCP credential and organization budgets

Input

statusstring

Optional exact QuickBooks sync job status filter.

one of: queued, enqueue_failed, processing, retrying, succeeded, partial_failed, failed, stuck, canceled

statusGroupstring

Status group to list when status is omitted. Actionable includes failed, stuck, enqueue-failed, and active jobs.

one of: actionable, active, terminal, all; default: "actionable"

operationstring

Optional QuickBooks sync operation filter.

one of: customer_invoice_create, customer_invoice_mark_paid, customer_payment_create, carrier_bill_create, carrier_bill_mark_paid, carrier_settlement_create, customer_invoice_update, carrier_bill_update

includeItemsboolean

Include per-item sync status and error details.

default: true

searchstring

Optional search across job IDs, operation, status, error text, item labels, and QuickBooks entity IDs.

min length: 1; max length: 100

limitinteger

default: 25; min: 1; max: 100

offsetinteger

default: 0; min: 0

Result

The tool returns the canonical ark.list_quickbooks_sync_jobs 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.