GET

/api/v1/balance

Fetch real-time comprehensive wallet financial metrics for the authenticated user, including total wallet balance, referral commissions, held/escrow funds, bonus rewards, and spendable available balance.

Request Headers

Header Type Required Description
Authorization string Required Bearer token (e.g. Bearer tente_sk_live_...)

Sample 200 Success Response

{
  "status": 200,
  "meaning": "Success",
  "message": "Wallet balances retrieved successfully.",
  "data": {
    "wallet_number": "4810293847",
    "balance": 150000.50,
    "commission": 12500.00,
    "hold_balance": 5000.00,
    "bonus": 2500.00,
    "available_balance": 145000.50,
    "currency": "NGN",
    "status": "active"
  }
}