List user transactions
Retrieve a paginated list of transactions across all funding sources (wallets, bank accounts, cards).
Filtering:
- Filter by
sourceto show only crypto, bank, or card transactions - Filter by
typefor specific transaction types (deposit, withdrawal, card_purchase, etc.) - Filter by
statusto find pending, completed, or failed transactions - Filter by
directionto separate incoming (in) vs outgoing (out) transactions - Filter by
categoryfor card/bank transactions (comma-separated for OR logic) - Use
amount_min/amount_maxfor amount range filtering - Use
from_date/to_datefor 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.
Authorizations
PINT (Purchase Intent) token — a JWT issued via POST /v0/sis/token/pint that encodes user-level consent for a specific scope. Sent in the x-sumvin-pint-token header alongside or instead of an x-juno-jwt JWT, depending on the integration surface (Platform vs SIS).
Headers
Tenant org ID for multi-tenant auth
Controls how timestamp fields are serialized in JSON response bodies.
Default (header omitted or any other value): epoch milliseconds as integers.
iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.
Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".
Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.
Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.
"iso8601"
Query Parameters
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 refund
crypto_wallet, bank_account, card Filter by account 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/provider
Card transactions:
card_purchase- Debit card spend at merchantcard_refund- Merchant-initiated refund to card
Bank 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 fee
deposit, 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 completion
pending, 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
Response
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)