Try the API and the feedback widget before you pay a single shilling.
- 100 free tokens on your first API key
- Full access to every endpoint
- Publishable keys for the web widget
- Balance, usage, keys & topup endpoints — free
- Priority support
The real cost. Top up anytime and every paid request spends exactly one token.
- 1 token = 1 request = TZS 1
- Top up from TZS 1,000 to TZS 200,000
- Instant credit via M-Pesa, Airtel or Tigo
- Tokens refunded when a request fails
- No subscription. Never expires.
High-volume customers get higher rate limits and bulk rates.
- Raised daily request caps
- Bulk token discounts
- Dedicated support & SLA
- Contract & invoice billing
- Same 1 token pricing otherwise
# How billing works
TumaMaoni API uses prepaid tokens instead of a subscription — you only ever pay for the requests you actually make.
Create an API key
Sign up, open the developer portal and create a key. You get 100 free tokens immediately.
Make requests
Every paid request debits exactly 1 token (TZS 1). Failed requests are refunded automatically.
Top up when low
Buy from TZS 1,000 with mobile money. Payment confirmed, balance updates instantly.
# Token prices
One transparent price for every paid request. Management endpoints are always free.
| Item | Price | Notes |
|---|---|---|
| PAIDPaid API request | 1 token | Debited per request, refunded on 4xx/5xx failures |
| PAIDToken price | TZS 1 | 1 token = TZS 1 = 1 request means 1000 requests for TZS 1k |
| FREEFree grant | 100 tokens | Credited automatically when you create your first API key |
| FREEWallet & key management | Free | Balance, usage, keys and topup endpoints never cost tokens |
| FREEFeedback widget | 1 token per submission | Same 1-token cost as the API — counted when feedback is submitted |
Top up limits
| Item | Value |
|---|---|
| Minimum topup | TZS 1,000 (1,000 tokens) |
| Maximum topup | TZS 200,000 (200,000 tokens) |
| Payment methods | M-Pesa, Airtel Money, Tigo Pesa (via CamelPay) |
| Low balance alert | Email when your balance drops below 500 tokens |
Quick topup amounts
| Amount | Tokens | Requests |
|---|---|---|
| TZS 1,000 | 1,000 | 1,000 |
| TZS 5,000 | 5,000 | 5,000 |
| TZS 10,000 | 10,000 | 10,000 |
| TZS 20,000 | 20,000 | 20,000 |
| TZS 50,000 | 50,000 | 50,000 |
| TZS 100,000 | 100,000 | 100,000 |
| TZS 200,000 | 200,000 | 200,000 |
4xx or 5xx status, the token is refunded to your wallet immediately — you never pay for errors.# Rate limits
Each API key has a daily request budget that resets at midnight (Tanzania time). Limits apply per key, not per account.
| Key type | Daily limit |
|---|---|
| Secret | 1,000 requests / day |
| Publishable | 100 requests / day |
Zero-token endpoints (keys, balance, usage, topup) count toward your daily cap too, but never cost tokens.
# FAQ
Do tokens expire?
No. Tokens you buy never expire, so you can top up whenever it suits you and use them at your own pace.
What happens when I run out of tokens?
Paid requests return a 402 Insufficient tokens error with a topup_url you can send your user to. Your app never has to hard-code the topup page.
Do I get a refund if a request fails?
Yes. Tokens are charged when a paid request begins and refunded automatically if it ends with a 4xx or 5xx status. Refunds appear in your token history.
Which payment methods are supported?
Mobile money: M-Pesa, Airtel Money and Tigo Pesa, processed through CamelPay. After payment is confirmed, tokens are credited to your wallet instantly.
Is there a free plan?
Yes — creating your first API key grants 100 free tokens, and balance, usage, keys and topup endpoints are always free. You only pay per paid request you make.
Can I get a higher rate limit?
Yes. On the Scale plan we raise your daily request caps, offer bulk discounts and give you dedicated support. Just get in touch.
Start building today
Create your account, get 100 free tokens and make your first request in under two minutes. No credit card, no commitment.