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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "timestamp": "2025-09-20T11:58:29.07647172",
    "status": 200,
    "success": true,
    "message": "Fetch  transactions successfully",
    "data": {
        "summary": {
            "totalIn": 10000.0,
            "totalOut": 1200.0
        },
        "transactions": [
            {
                "amount": 500.0000,
                "currency": "NGN",
                "date": "2025-09-10T22:05:05.997286",
                "id": "f4452269-1410-403c-83d3-cbf9a5841bb6",
                "direction": "DEBIT",
                "narration": null,
                "status": "SUCCESS",
                "type": "BILL_PAYMENT",
                "fee": null,
                "total": null
            },
            {
                "amount": 200.0000,
                "currency": "NGN",
                "date": "2025-09-10T21:56:37.659573",
                "id": "79e39533-15e0-4cdc-af47-d9931a6d4d21",
                "direction": "DEBIT",
                "narration": null,
                "status": "SUCCESS",
                "type": "BILL_PAYMENT",
                "fee": null,
                "total": null
            },
            {
                "amount": 10000.0000,
                "currency": "NGN",
                "date": "2025-09-10T21:54:52.812472",
                "id": "f9a4fa98-0ba6-429b-8dd0-197890c4c907",
                "direction": "CREDIT",
                "narration": "Free testing bonus",
                "status": "SUCCESS",
                "type": "DEPOSIT",
                "fee": null,
                "total": null
            }
        ],
        "meta": {
            "page": 1,
            "limit": 100,
            "totalItems": 3,
            "totalPages": 1
        }
    }
}

🟠401Unauthorized

🟠404Record not found