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

List data plans

/bills/get_data_planGET
Returns the data bundles available for a network, sorted by price.
Network IDs: 1 MTN, 2 GLO, 3 9mobile, 4 Airtel.
variation_id is the position of the plan in this list, so it can change when plans change. Always fetch the list shortly before buying and send the variation_id from that fetch.
Authorization
bearerAuth *Bearer <token>
Your API token from the SendCheap business dashboard.
Query Parameters
network_id *1 | 2 | 3 | 4
Network: 1 MTN, 2 GLO, 3 9mobile, 4 Airtel.
Response
200 · Data plans
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.
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.
Request example
curl -X GET "https://api.sendcheap.us/apps/business/bills/get_data_plan?network_id=1" \ -H "Authorization: Bearer <token>"
Response example
{ "status": "success", "message": "successful", "data": [ { "discription": "(₦300) - 1 Day - 1DAY", "amount": "300", "bundle_code": "MTN-1GB-1D", "network_id": 1, "plan_bundle": "1 Day", "expiration": "1DAY", "variation_id": "1" }, { "discription": "(₦1500) - 30 Days - 30DAYS", "amount": "1500", "bundle_code": "MTN-2GB-30D", "network_id": 1, "plan_bundle": "30 Days", "expiration": "30DAYS", "variation_id": "2" } ] }