GET
/
transaction

Returns a paginated list of transactions across the wallets the caller can see. Without filters, this includes every wallet under the authenticated Business — primary plus any outlet wallets you have created.

Scoping by walletId

Pass ?walletId=<id> to scope the listing to a single wallet. walletId accepts either:

  • the 10-digit NUBAN of a primary wallet, or
  • a wal_<26-char-ULID> identifier returned in outlet.collectionWallet.walletId / outlet.depositWallet.walletId.

A walletId that does not belong to your Business returns an empty page rather than an authorization error — silent scoping matches the rest of the listing API.

Other filters

sessionId, transactionAccount, transactionReference, and customerReference are also accepted as query parameters and combine with walletId.

Authorizations

x-api-key
string
headerrequired
x-api-secret
string
headerrequired

Query Parameters

sessionId
string

Unique identifier for the session

transactionAccount
string

Account associated with the transaction

transactionReference
string

Transaction reference

customerReference
string

Customer reference for the transaction

walletId
string

Scope the listing to a single wallet. Accepts either the 10-digit NUBAN of a primary wallet or the wal_<26-char-ULID> identifier of an outlet wallet. Omit to list across every wallet the caller can see.

Response

200 - application/json
status
boolean
required

Indicates if the request was successful

statusCode
integer
required

HTTP status code of the response

data
object
required
message
string
required

Response message describing the result of the request