List wallet transactions
Lists a wallet's transactions, newest first, with optional filters.
Lists a wallet's transactions, newest first, with optional filters.
Returns { transactions, pagination }. In a transaction, type debit takes funds from the
wallet and credit adds funds to it; source says why (topUp, payOut,
order, exchange or reversal), and orderId names the order a payment or refund
belongs to. Filters combine with AND and apply before counting and paging.
Use flat page (default 1) and limit (default 10, 1 to 100) query parameters.
cursor, skip, offset, nested paging keys and repeated paging parameters return
400 with code 10001 (INVALID_REQUEST). An unknown wallet returns 404 with code
10004.
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
walletId*stringWallet id.
uuidpage?integerOne-based page number. Default 1.
int32limit?integerPage size, 1 to 100. Default 10.
int32startDate?stringOnly transactions made at or after this time (UTC). ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day.
date-timeendDate?stringOnly transactions made at or before this time (UTC). ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day.
date-timetype?stringOnly this direction: debit takes funds from the wallet, credit adds funds to it.
"debit""credit"source?stringOnly transactions with this cause, such as order or exchange.
"topUp""payOut""order""exchange""reversal"OK
- response
A page of a wallet's transactions, newest first.
transactions*array<>The transactions on this page.
pagination*Paging of the list.
curl -X GET 'https://api.sandbox.openroam.com/v1/wallets/7c9e6679-7425-40de-944b-e07fc1f90ae7/transactions?page=1&limit=10&startDate=2026-10-01T00%3A00%3A00Z&endDate=2026-10-31T23%3A59%3A59Z&type=debit'{ "transactions": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "type": "debit", "source": "topUp", "amount": 0, "currency": "string", "description": "string", "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5", "originalAmount": 0, "originalCurrency": "string", "conversionRate": 0, "date": "2019-08-24T14:15:22Z" } ], "pagination": { "currentCount": 0, "totalCount": 0, "skip": 0, "limit": 0, "hasMore": true, "page": 0, "totalPages": 0 }}Get a wallet GET
Gets one wallet with its totals. Adds `lowBalanceThreshold`, `createdAt`, `updatedAt` and totals of completed transactions to the list fields. An unknown wallet, or one of another partner, returns `404` with code `10004`.
Select a wallet PATCH
Makes a wallet the partner's selected wallet, which pays for new orders. Exactly one wallet is selected at a time; the previously selected wallet is deselected. An unknown wallet returns `404` with code `10004` and leaves the current selection unchanged.