Skip to main content
GET
List wallet transactions

Overview

GET /wallet/transactions returns wallet transactions across every wallet your company owns, with optional filtering. For a per-wallet view, use GET /wallet/transactions/wallet/{walletId} instead.

When to use it

  • Render a global activity feed in your dashboard.
  • Find a transaction by its ID without knowing which wallet it belongs to.
  • Reconcile total wallet activity over a date range.

Prerequisites

  • Authenticated as a company user.

Request

Headers

Query parameters

Pagination quirk: unlike most other list endpoints, this one uses limit / offset (not page / limit). We are aligning this in a future release; meanwhile, compute offset = (page - 1) * limit to translate.

Response

200 — Success

The per-transaction shape matches GET /wallet/transactions/wallet/{walletId} — see that page for the full field reference.

Error responses

Code examples

cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

transactionId
string

Filter by a specific transaction ID.

walletId
string<uuid>

Filter by wallet ID.

customerId
string<uuid>

Filter by customer ID.

status
string

Filter by transaction status (e.g. SUCCESS, PENDING, FAILED).

limit
integer

Maximum number of records to return.

offset
integer

Number of records to skip.

Response

200 - application/json

A list of wallet transactions for the company.

success
boolean
Example:

true

statusCode
integer
Example:

200

message
string
Example:

"Data retrieved successfully"

data
object[]
pagination
object