Skip to main content
GET
List Wallet Transactions
Retrieve a paginated list of wallet transactions, newest first, with optional filtering by currency, type, status, date range, and search term.

Example Request

Query Parameters

Transactions with status failed are left out unless you ask for them with status=failed. status=completed also returns pending transactions our operations team has already claimed, which are reported as completed; status=pending excludes them.

Example Response

Amounts are in minor units — 500000 is ₦5,000.00. Fields that do not apply to a transaction are omitted rather than returned as null: exchange_rate appears on swaps only, virtual_account, payer and payment_rail on deposits only, and uetr only once a cross-border payout has been assigned one.
Use date range filters to export transaction data for specific periods. Combine with the status filter to find failed transactions that may need to be retried.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Query Parameters

currency
string

Filter by source currency, so a swap is listed under the currency it was sold from rather than under both.

Required string length: 3 - 4
Example:

"NGN"

transactionType
enum<string>

Filter by type. fee lists fees booked as transactions of their own.

Available options:
deposit,
withdrawal,
swap,
card_funding,
payin,
fee
Example:

"withdrawal"

status
enum<string>

Filter by status. completed also returns pending transactions operations have already claimed; pending excludes them.

Available options:
pending,
completed,
failed,
rejected,
sent,
negotiating,
cancelled
Example:

"completed"

page
integer
default:1

Page number, starting at 1.

Required range: x >= 1
pageSize
integer
default:20

Rows per page. Caps at 100.

Required range: 1 <= x <= 100
startDate
string<date>

Inclusive start, YYYY-MM-DD.

Example:

"2024-01-01"

endDate
string<date>

Inclusive end, YYYY-MM-DD.

Example:

"2024-01-31"

Match on external reference, case-insensitive substring.

Example:

"ref-abc"

Response

A page of transactions

status
integer
required
Example:

200

message
string
required
Example:

"Transaction history retrieved successfully"

success
boolean
required
Example:

true

data
object
required

A page of transactions, newest first, with its paging fields alongside.