List unified financial transactions
Returns the org's money-movement ledger across manual payments, gateway payment attempts, wallet transactions, and credit notes - newest first, cursor-paginated. Each row is normalized into the same shape so the dashboard can mix kinds in one list.
query Parameters
limitPage size. Values above the server-side cap are clamped (standard default 50, cap 200; a few document-heavy lists use larger windows). Invalid values fall back to the default.
cursorOpaque continuation token from the previous response's pagination.cursor. Omit for the first page. Cursors are stateless and do not expire, but are only valid for the list and filters that produced them.
kindFilter by transaction kind (manual_payment, payment_attempt, wallet_transaction, wallet_hold, credit_note). Repeatable or comma-separated.
Filter by transaction kind (manual_payment, payment_attempt, wallet_transaction, wallet_hold, credit_note). Repeatable or comma-separated.
statusFilter by unified status (succeeded, pending, failed, refunded, voided, applied, draft). Repeatable or comma-separated.
Filter by unified status (succeeded, pending, failed, refunded, voided, applied, draft). Repeatable or comma-separated.
directionFilter by money direction: in | out | internal
Filter by money direction: in | out | internal
customer_idFilter by customer UUID
Filter by customer UUID
invoice_idFilter by invoice UUID (skips wallet transactions, which don't reference invoices)
Filter by invoice UUID (skips wallet transactions, which don't reference invoices)
occurred_afterFilter by occurred_at >= timestamp (RFC3339)
Filter by occurred_at >= timestamp (RFC3339)
occurred_beforeFilter by occurred_at < timestamp (RFC3339)
Filter by occurred_at < timestamp (RFC3339)
searchCase-insensitive substring match over each row's reference, summary, and source
Case-insensitive substring match over each row's reference, summary, and source
Headers
X-Workspace-IdSelects the workspace this request operates in, by workspace UUID or slug (e.g. a sandbox workspace for test integrations). Omitted: the organization's default live workspace. Unknown workspace: 404; workspace outside your organization: 403. Discover workspaces via GET /workspaces.
Workspace UUID or slug.
List unified financial transactions › Responses
OK