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

Name	Type	Description
secret-key	string	Your vesicash secret key
public-key	string	Your Vesicash 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": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-12T16:51:55.285126Z"
        },
            "currency_code": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-12T16:43:45.082621Z"
        },
        {
            "id": "1329ef10-a328-4dfb-9083-de37a1cd6cc2",
            "balance_before": 118.73,
            "balance_after": 119.73,
            "amount": 1,
            "action": "card-payment",
            "type": "credit",
            "wallet_id": "7a6b5247-0080-49eb-b440-45c48b2cfb7e",
            "reference": "PY_63055d1600e542768792e0983",
            "currency_code": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-12T12:45:02.829338Z"
        },
        {
            "id": "2334203a-44ea-47fe-8b00-22d4c073f759",
            "balance_before": 120.73,
            "balance_after": 118.73,
            "amount": 2,
            "action": "payout",
            "type": "debit",
            "wallet_id": "7a6b5247-0080-49eb-b440-45c48b2cfb7e",
            "reference": "PY_1fc9629f1162491b80d482e75",
            "currency_code": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-12T11:17:49.000636Z"
        },
        {
            "id": "304633a3-4948-442c-b39c-73112cd7326e",
            "balance_before": 119.73,
            "balance_after": 120.73,
            "amount": 1,
            "action": "card-payment",
            "type": "credit",
          
        {
            "id": "2835574f-2ba1-4e92-ba8b-",
            "balance_before": 119.73,
            "balance_after": 120.73,
            "amount": 1,
            "action": "refund",
            "type": "credit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-05T11:31:42.750002Z"
        },
        {
            "id": "6ed9e757-9caf-497c-a095-",
            "balance_before": 120.73,
            "balance_after": 119.73,
            "amount": 1,
            "action": "payout",
            "type": "debit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-05T11:31:27.956157Z"
        },
        {
            "id": "3d989d44-e8ac-4bf3-a8f9-",
            "balance_before": 121.73,
            "balance_after": 120.73,
            "amount": 1,
            "action": "payout",
            "type": "debit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-05T11:30:08.855668Z"
        },
        {
            "id": "e4af8ece-9ff1-4419-9363-",
            "balance_before": 122.73,
            "balance_after": 121.73,
            "amount": 1,
            "action": "payout",
            "type": "debit",
            "wallet_id": "7a6b5247-0080-49eb-b440-",
            "reference": "",
            "currency_code": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-05T11:11:58.958077Z"
        },
        {
            "id": "777bf346-25f0-4015-9e16-",
            "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": "GHS",
            "country_code": "GH",
            "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": "GHS",
            "country_code": "GH",
            "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": "GHS",
            "country_code": "GH",
            "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": "GHS",
            "country_code": "GH",
            "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": "GHS",
            "country_code": "GH",
            "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": "GHS",
            "country_code": "GH",
            "balance_at": "2026-01-05T09:21:53.340784Z"
        }
    ],
    "pagination": [
        {
            "current_page": 1,
            "page_count": 20,
            "total_pages_count": 7
        }
    ]
}