Fetch Account Transactions

Returns a paginated, filterable list of all ledger-backed transactions for the given account (wallet or savings), plus a month-to-date In/Out summary.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "timestamp": "2025-05-21T15:00:00Z",
    "status": 200,
    "success": true,
    "message": "Transactions fetched",
    "data": {
        "summary": {
            "in": 20000,
            "out": 20000
        },
        "transactions": [
            {
                "transactionId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
                "type": "P2P",
                "description": "Transfer from James",
                "timestamp": "2025-04-20T14:39:00Z",
                "amount": 2000,
                "direction": "IN",
                "status": "SUCCESS",
                "iconUrl": "https://cdn.xtrempay.com/icons/transfer-in.png"
            },
            {
                "transactionId": "b2c3d4e5-6789-01bc-defa-2345678901bc",
                "type": "AIRTIME",
                "description": "MTN Airtime",
                "timestamp": "2025-04-20T14:39:00Z",
                "amount": 2000,
                "direction": "OUT",
                "status": "FAILED",
                "iconUrl": "https://cdn.xtrempay.com/icons/airtime.png"
            }
        ]
    },
    "meta": {
        "page": 1,
        "limit": 20,
        "totalItems": 2,
        "totalPages": 1
    }
}

🟠401Unauthorized

🟠404Record not found