Get wallet balance

GET

/v1/developer/balance

Your current wallet balance, dedicated PIN wallet balance, and bank accounts for funding your wallet.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/developer/balance' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "success": true,
    "message": "Request successful",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "balance": 25000,
        "pinBalance": 5000,
        "currency": "NGN",
        "chargeSource": "PIN",
        "virtualAccountNumber": "4114936835",
        "virtualBankName": "Wema bank",
        "virtualAccounts": [
            {
                "bankName": "Wema bank",
                "accountNumber": "4114936835",
                "accountName": "Dailybest"
            },
            {
                "bankName": "Sterling bank",
                "accountNumber": "4422913828",
                "accountName": "Dailybest"
            }
        ]
    }
}

Modified at 2026-10-07 17:31:05

Check a data purchase

Buy airtime