Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Quickstart: first API call and airtime purchase

This guide takes you from API token to a verified airtime purchase in three requests. You need a funded business wallet and a token from the dashboard.

1. Check your balance

Every request sends your token in the Authorization header.
Request
curl https://api.sendcheap.us/apps/business/payment/get_wallet_balance \ -H "Authorization: Bearer $SENDCHEAP_TOKEN"
Response
{ "status": "success", "message": "successful", "data": { "account_number": "9876543210", "account_name": "SENDCHEAP(ACME STORES)", "ngn_balance": "250000.00", "ngn_fronzen": "0.00", "usd_balance": "0.00", "usd_fronzen": "0.00", "updated_at": "2026-11-21 10:15:02", "tier_account": "BUSINESS", "bank_name": "Rubies MFB" } }
Store the token in an environment variable such as SENDCHEAP_TOKEN, never in source code.

2. Buy airtime

POST bodies are JSON. Send a tranx_id you generate yourself; it is how you find this purchase again.
Request
curl -X POST https://api.sendcheap.us/apps/business/bills/buy_airtime \ -H "Authorization: Bearer $SENDCHEAP_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "network_id": 1, "phone": "08031234567", "amount": 1000, "tranx_id": "ACME-20261121-000185" }'
Response
{ "status": "success", "message": "Your Airtime Purchase To 08031234567 Was Successful... Thank You", "data": { "id": 81234, "tranx_status": 1, "order_id": "ACME-20261121-000185", "tranx_type": 2, "network": "MTN", "amount": "1000.00", "charge": "0.00", "phone": "08031234567", "balance_state": "{\"balance_before\":\"250,000.0000\",\"balance_after\":\"249,000.0000\"}", "created_at": "2026-11-21 10:15:02", "updated_at": "2026-11-21 10:15:02", "percent": "0", "channel": "APP", "app_meta_data": null } }
Network IDs: 1 MTN, 2 GLO, 3 9mobile, 4 Airtel.
The record in data is a snapshot taken before the purchase, so tranx_status shows 1 even on success. Trust the message and HTTP status, or call Verify bill.

3. Verify the purchase

If the response said Queued, or you are unsure, verify with the same tranx_id.
Request
curl "https://api.sendcheap.us/apps/business/bills/verify_transaction?tranx_id=ACME-20261121-000185" \ -H "Authorization: Bearer $SENDCHEAP_TOKEN"
HTTPmessageWhat to do
200transaction successfulDone
400transactionf still pending....Check again in a minute
417transaction faield... reverse recordFailed, your wallet was refunded

What next