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

Buy data

/bills/buy_dataPOST
Buys a data bundle for a phone number. The price comes from the plan, and your wallet is debited for it.
  • Your Data Purchase ... Was Successful (data.tranx_status may still show 1 in this response) means the bundle was delivered.
  • Data Purchase Queued... means the provider is still processing it. Poll Verify bill with your tranx_id until it settles.
  • Failed And Reversed means it failed and your wallet has been refunded.
Authorization
bearerAuth *Bearer <token>
Your API token from the SendCheap business dashboard.
Request Bodyapplication/jsonrequired
network_id *1 | 2 | 3 | 4
Network: 1 MTN, 2 GLO, 3 9mobile, 4 Airtel.
Example: 1
phone *string
Recipient phone number, 11 digits.
Example: "08031234567"Min length: 11
variation_id *string
The plan variation_id from List data plans.
Example: "2"
tranx_id *string
Your unique reference for this request, at least 10 characters. A reference can only be used once; reusing it returns "duplicate transaction detected". Store it so you can verify the transaction later.
Example: "ACME-20261121-000184"Min length: 10
Response
200 · Delivered or queued
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
400 · Missing or invalid field
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
401 · Outcome unknown
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
406 · Missing or invalid API token
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
417 · Rejected
status *"success" | "failed"
success when the request did what you asked.
message *string
Human-readable result.
data *object
The result. Shape depends on the endpoint; null on most errors.
Request example
curl -X POST "https://api.sendcheap.us/apps/business/bills/buy_data" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "network_id": 1, "phone": "08031234567", "variation_id": "2", "tranx_id": "ACME-20261121-000184" }'
Response example
{ "status": "success", "message": "Your Data Purchase To 08031234567 Was Successful... Thank You", "data": { "id": 81234, "tranx_status": 1, "order_id": "ACME-20261121-000184", "tranx_type": 3, "network": "MTN", "amount": "1500.00", "charge": "0.00", "phone": "08031234567", "balance_state": "{\"balance_before\":\"250,000.0000\",\"balance_after\":\"248,500.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 } }