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. Prepay responses include billing_type only; postpay also returns credit_limit, credit_used, and credit_available.

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

Prepay

Expected response for Prepay:

200 OKSample dataExpected 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"
}

Postpay

Expected response for Postpay:

200 OKSample dataExpected response

{
  "success": true,
  "response_code": 200,
  "message": "Wallet balance fetched successfully",
  "data": {
    "available_balance": 11347.48,
    "billing_type": "postpay",
    "credit_available": 4962885.98,
    "credit_limit": 4999999.98,
    "credit_used": 37114,
    "currency": "KES",
    "status": "active",
    "wallet_account": "PEL305959008271"
  },
  "request_id": "4f36ab05-d6d4-4d1f-9413-58d5a177464b"
}

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 (credit_limit − credit_used)
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.