Get wallet histories

This endpoint makes an HTTP GET request to retrieve a list of successfull transactions with pagination. The request includes query parameters for the number page and limit of results per page.

GET:v1/account/get-wallet-histories

Params

Name	Type	Description
page	Integer	The page number for paginated results
timestamp	integer	The timestamp of the ending time

Headers

secret-key	string	Your Redstone secret key
public-key	string	Your Redstone public key

Response

The response will be in JSON format and will have the following schema:

{
    "status": "success",
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": "50f86bf7-6",
            "balance_before": 119.63,
            "balance_after": 119.73,
            "amount": 0.1,
            "action": "refund",
            "type": "credit",
            "wallet_id": "7a6b5247-0080-",
            "reference": "PY_cf390d12",
            "currency_code": "ZMW",
            "country_code": "ZM",
            "balance_at": "2026-01-12T16:51:55.285126Z"
        },
            "balance_before": 121.73,
            "balance_after": 122.73,
            "amount": 1,
            "action": "mobile-money-payment",
            "type": "credit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "ZMW",
            "country_code": "ZM",
            "balance_at": "2026-01-05T11:09:12.589033Z"
        },
        {
            "id": "c0fb30d9-6c22-482a-b345-",
            "balance_before": 122.73,
            "balance_after": 121.73,
            "amount": 1,
            "action": "payout",
            "type": "debit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "ZMW",
            "country_code": "ZM",
            "balance_at": "2026-01-05T11:02:43.570271Z"
        },
        {
            "id": "78e7a810-b53a-40a8-84d4-",
            "balance_before": 123.73,
            "balance_after": 122.73,
            "amount": 1,
            "action": "payout",
            "type": "debit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "ZMW",
            "country_code": "ZM",
            "balance_at": "2026-01-05T10:36:02.749439Z"
        },
        {
            "id": "3a0b5e7f-ee3f-4adc-903d-",
            "balance_before": 122.73,
            "balance_after": 123.73,
            "amount": 1,
            "action": "card-payment",
            "type": "credit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "ZMW",
            "country_code": "ZM",
            "balance_at": "2026-01-05T10:31:49.922202Z"
        },
        {
            "id": "181ad166-d79b-4d4e-a617-",
            "balance_before": 124.73,
            "balance_after": 122.73,
            "amount": 2,
            "action": "payout",
            "type": "debit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "ZMW",
            "country_code": "ZM",
            "balance_at": "2026-01-05T10:29:32.571139Z"
        },
        {
            "id": "8e48fcf9-87c0-4ab5-bc6e-",
            "balance_before": 123.73,
            "balance_after": 124.73,
            "amount": 1,
            "action": "card-payment",
            "type": "credit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "PY_fce698bd970",
            "currency_code": "ZMW",
            "country_code": "ZM",
            "balance_at": "2026-01-05T09:21:53.340784Z"
        }
    ],
    "pagination": [
        {
            "current_page": 1,
            "page_count": 20,
            "total_pages_count": 7
        }
    ]
}