Retrieve a paginated list of transactions across all funding sources (wallets, bank accounts, cards).
Filtering:
source to show only crypto, bank, or card transactionstype for specific transaction types (deposit, withdrawal, card_purchase, etc.)status to find pending, completed, or failed transactionsdirection to separate incoming (in) vs outgoing (out) transactionscategory for card/bank transactions (comma-separated for OR logic)amount_min/amount_max for amount range filteringfrom_date/to_date for date range filtering (epoch ms or YYYY-MM-DD)Metadata:
Set meta=true to include aggregate statistics: transaction count, date range,
gross in/out cashflow, and category breakdown with percentages.
Pagination:
Default limit is 50 (max 100). Use offset for cursor-based pagination.
Response includes pagination links in _links.
Filter by transaction source Origin system for a transaction. Used to filter transactions by funding source.
crypto_wallet - On-chain transaction from user's EOA or Safe walletbank_account - ACH/wire transfer from linked bank accountcard - Debit card purchase or refundcrypto_wallet, bank_account, card Filter by account external_id
Filter by wallet id
Filter by card id
Filter by transaction type Classification of financial transaction types.
Crypto/Wallet transactions:
deposit - Incoming transfer to user's wallet from external sourcewithdrawal - Outgoing transfer from user's wallet to external addresstransfer - Internal movement between user's own walletsswap - Token exchange (e.g., ETH → USDC)on_ramp - Fiat-to-crypto conversion via exchange/provideroff_ramp - Crypto-to-fiat conversion via exchange/providerCard transactions:
card_purchase - Debit card spend at merchantcard_refund - Merchant-initiated refund to cardBank account transactions:
bank_transfer - ACH/wire transfer between accountsdirect_debit - Recurring automated payment (bills, subscriptions)standing_order - Scheduled fixed paymentbank_payment - One-time outgoing paymentbank_refund - Return of funds to bank accountinterest - Interest credit on savings/checking accountfee - Bank service charge or maintenance feedeposit, withdrawal, transfer, swap, card_purchase, card_refund, on_ramp, off_ramp, bank_transfer, direct_debit, standing_order, bank_payment, bank_refund, interest, fee Filter by transaction status Lifecycle state of a transaction.
State progression: pending → processing → completed | failed | cancelled
pending - Transaction created but not yet submitted for processingprocessing - Submitted to network/provider, awaiting confirmationcompleted - Successfully finalized (on-chain confirmed or bank settled)failed - Transaction rejected or reverted (check error details)cancelled - User or system cancelled before completionpending, processing, completed, failed, cancelled Filter by transaction direction Direction of fund flow relative to user's account.
in - Funds entering user's account (credits, deposits, refunds)out - Funds leaving user's account (debits, payments, withdrawals)in, out Filter by category. Comma-separated for OR logic (e.g., 'groceries,restaurants,coffee')
Filter by merchant name (case-insensitive partial match)
Filter by merchant category code (4-digit MCC)
Filter transactions with amount >= this value
Filter transactions with amount <= this value
Filter transactions on or after this date. Accepts epoch ms or YYYY-MM-DD
Filter transactions on or before this date. Accepts epoch ms or YYYY-MM-DD
Pagination offset
x >= 0Pagination limit
1 <= x <= 100Include meta statistics about returned transactions
Transactions retrieved successfully
Paginated list of transactions with optional metadata.
HAL-style hypermedia links for navigation.
List of transactions
Total number of transactions matching filters
Current pagination offset
Maximum results per page
Aggregate statistics (only present when meta=true)