Check airtime balance

X-API-Key

POST/airtime-to-cash/balance

Optional refresh of the line's airtime balance using an active session_id.

Language

curl -X POST "https://api.vendpower.ng/api/v1/airtime-to-cash/balance" \
  -H "X-API-Key: YOUR_X_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "session_id": "a2c_sess_abc123"
  }'

Authentication

Send your approved API key on every request. Keep it on your server only.

Header	Value	Required
X-API-Key	YOUR_X_API_KEY	Yes
Content-Type	application/json	Yes
Accept	application/json	Recommended

Authentication failures (401 / 403 / 429) are listed in Authentication.

Parameters

Body parameters

Name	Type	Required	Description
session_id	string	Yes	From verify OTP

Responses

200 OK — Balance

{
  "success": true,
  "message": "Balance retrieved.",
  "data": {
    "msisdn": "2348031234567",
    "airtime_balance": 2500.5,
    "airtime_value": "₦2,500.50"
  }
}