Get balance

GET/account-api/balance

Returns the wallet balance (GHS) used for payments, airtime and data, and the SMS credit balance used for messaging and OTP. Team member keys read the owning account's balances.

Errors

403Your account is blocked.

Request

curl -X GET "https://api.bulkclix.com/api/v1/account-api/balance" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

Response · 200

application/json

{
  "message": "Balance retrieved successfully",
  "data": {
    "wallet_balance": 250.75,
    "sms_balance": 1200,
    "currency": "GHS"
  }
}