A single API call sends airtime to up to 1,000 Safaricom, Airtel or Telkom subscribers — from KSh 10 to KSh 5,000 each. Discount-tracked, delivery-confirmed, batch-billed against your project balance.
An array of { number, amount } pairs (amount as "KES 100"). Up to 1,000 per request. Numbers get normalised automatically.
Sozuri responds synchronously with per-recipient acceptance, a unique requestId per entry, and any carrier-side discounts.
The carrier confirms credit landed; Sozuri fires an airtimeDelivery webhook per recipient with the final status.
Pass recipients as a JSON array. Sozuri detects carrier per number, routes accordingly, applies the discount tier and posts to the carrier on your behalf.
status + requestId# Reward 3 customers with KSh 100 airtime each
curl -X POST "https://api.sozuri.net/v1/airtime/topup" \
-H "Authorization: Bearer $SOZURI_API_KEY" \
-d '{
"project": "Galaxion Rewards",
"recipients": [
{ "number": "+254712345678", "amount": "KES 100" },
{ "number": "+254723456789", "amount": "KES 100" },
{ "number": "+254734567890", "amount": "KES 100" }
]
}'
# Response (synchronous)
{
"recipientsCount": 3,
"totalAmount": "KES 300",
"totalDiscount": "KES 6",
"responses": [
{ "number": "+254712345678", "amount": "KES 100", "discount": "KES 2", "status": "accepted", "requestId": "AIR-A1B2" },
...
]
}Pay respondents KSh 50–200 in airtime the moment they finish your form. Higher completion rates than M-Pesa for small amounts.
Birthday bonuses, milestone gifts, gamified incentives. Airtime feels like a treat; small M-Pesa amounts feel like change.
Reps and field officers love airtime that doubles as data for their next shift. Pay daily, weekly or per-task — in seconds.
Outage credits, customer-service apologies, dispute settlements. Cheaper and faster than a bank transfer for small amounts.
Sports, quiz and gaming prize pools. Hand out a thousand KSh 50 winnings in one API call after the final whistle.
SaaS or insurance teams running a "we miss you" campaign — KSh 20 airtime is the cheapest "tap to see what's new" you can buy.
Telkom Kenya is supported on a best-effort basis. Safaricom and Airtel are the primary topup networks, with Telkom routed through the same endpoint where available. Per-network status is reported on the response.
Faiba 4G uses a separate product code. Sozuri detects the number and routes appropriately; you don't pass a network identifier. Faiba support depends on current carrier peering — check with your account manager for live status.
Carriers offer volume-tier discounts on airtime distribution. Sozuri passes those on to you, less the platform fee. The discount field on each response tells you the net cost.
Subscribers typically see the balance update within seconds of acceptance. The airtimeDelivery webhook fires when the carrier confirms credit — usually inside 30 seconds.
Whether it's a survey reward or a goodwill credit, airtime hits faster than M-Pesa for small amounts and feels more like a gift. One call, a thousand smiles.