Check Balance

You can retrieve and display the updated balance of your wallet in any of the currencies available, via the API. On top of that, to easily see your wallet balance, it is displayed on the dashboard of your Wallet tab. Negative figures mean you are owing a balance because transactions will be authenticated by Curacel even with insufficient funds.

Retrieve Balance from the API

Send a GET request to the Get the balance of your wallets endpoint. It takes one query parameter called wallet, which specifies the currency of the wallet balance you want to retrieve. If omitted, the response is a list of balances in all currencies.

Your API key is required to authenticate and authorize this request.

Request

curl --location --request GET 'https://api.playbox.grow.curacel.co/api/v1/partners/wallet/balance' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>'

Response

[
    {
        "currency": "GHS",
        "balance": "-4372.58"
    },
    {
        "currency": "KES",
        "balance": "100.00"
    },
    {
        "currency": "NGN",
        "balance": "855765.29"
    },
    {
        "currency": "USD",
        "balance": "0.00"
    }
]