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

Verify bill

/bills/verify_transactionGET
Returns the final status of a bill payment by your tranx_id. Use this for every queued purchase and before retrying.
HTTPMeaning
200Successful
400Still pending, check again later
417Failed and refunded to your wallet
404No bill with this tranx_id
Authorization
bearerAuth *Bearer <token>
Your API token from the SendCheap business dashboard.
Query Parameters
tranx_id *string
The tranx_id you sent when buying.
Min length: 10
Response
200 · Successful
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.
404 · Not found
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 · Failed and refunded
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/verify_transaction?tranx_id=ACME-20261121-000184" \ -H "Authorization: Bearer <token>"
Response example
{ "status": "success", "message": "transaction successful", "data": { "order_id": "ACME-20261121-000184", "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, "tranx_name": "AIRTIME PURCHASE", "status_name": "SUCCESSFUL", "bill_tranx_id": 81234 } }