Get Customer Wallet Balance

The Monnify "Get Customer Balance" API facilitates the retrieval of a customer's available balance by providing their wallet account number.

This endpoint is protected with a Basic Authentication. You are to send HTTP requests with the Authorization header that contains the word Basic followed by a space and a base64-encoded string apiKey:clientSecret.

Endpoint URL: {{base_url}}/api/v1/disbursements/wallet/balance?accountNumber={walletAccountNumber}

HTTP Method: GET

The {{base_url}} for the test is https://sandbox.monnify.com but when you go live, it changes to the live URL

Sample wallet balance response

{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "availableBalance": 1999.19,
        "ledgerBalance": 1999.19
    }
}

Field Reference

Field	Description
walletAccountNumber	The internal wallet account id returned from the wallet creation API