Wallet Balance

Retrieve your current wallet balance and billing profile. Auth required; this endpoint is not billed. For KES wallets on VAT-enabled tenants, subsequent verification calls may debit subtotal + VAT.

Request

GET/api/v1/wallet/balance

{{baseUrl}}/api/v1/wallet/balance

Header

Header	Type	Description
Authorization	string	Bearer YOUR_ACCESS_TOKEN
Accept	string	application/json

Response

200 OKSample dataExample response

{
  "success": true,
  "response_code": 200,
  "message": "Wallet balance fetched successfully",
  "data": {
    "wallet_account": "PEL305959008271",
    "available_balance": 1000.00,
    "currency": "KES",
    "status": "active",
    "billing_type": "prepay"
  },
  "request_id": "00000000-0000-0000-0000-000000000000"
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
response_code	number	Application response code
message	string	Human-readable status message
data.wallet_account	string	Wallet account identifier
data.available_balance	number	Spendable balance
data.currency	string	Wallet currency (e.g. KES, USD)
data.status	string	Wallet status (e.g. "active")
data.billing_type	string	"prepay" or "postpay"
data.credit_limit	number	Postpay only — credit limit
data.credit_used	number	Postpay only — credit used
data.credit_available	number	Postpay only — remaining credit
request_id	string	UUID for support and audit trails

Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.