Skip to Content
OpenRoam Docs
Wallets

List wallet transactions

Lists a wallet's transactions, newest first, with optional filters.

GET
/v1/wallets/{walletId}/transactions

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.

Authorization

PartnerApiKey
headerX-Partner-Key<token>

Partner API Key (X-Partner-Key)

Path Parameters

walletId*string

Wallet id.

Formatuuid

Query Parameters

page?integer

One-based page number. Default 1.

Formatint32
limit?integer

Page size, 1 to 100. Default 10.

Formatint32
startDate?string

Only 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.

Formatdate-time
endDate?string

Only 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.

Formatdate-time
type?string

Only this direction: debit takes funds from the wallet, credit adds funds to it.

Value in"debit""credit"
source?string

Only transactions with this cause, such as order or exchange.

Value in"topUp""payOut""order""exchange""reversal"

Response Body

OK

  1. response

A page of a wallet's transactions, newest first.

transactions*array<>

The transactions on this page.

pagination*

Paging of the list.

Example Request
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'
Example Response
{  "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  }}