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

Buy electricity

/bills/buy_electricityPOST
Buys electricity units for a meter. Minimum amount is ₦200. The meter is verified again before payment.
For prepaid meters the token is returned in data.token on success. If the purchase is queued, the token is delivered once Verify bill shows it as successful.
Authorization
bearerAuth *Bearer <token>
Your API token from the SendCheap business dashboard.
Request Bodyapplication/jsonrequired
disco_name *string
Provider id, name or m_id.
Example: "IKEDC"
meter_no *string
Meter number.
Example: "45031234567"
amount *number
Amount in naira. Minimum 200.
Example: 5000Min: 200
phone *string
Customer phone number, 11 digits.
Example: "08031234567"Min length: 11
name *string
Customer name (from Resolve meter).
Example: "ADEBAYO OLUWASEUN"
address *string
Customer address (from Resolve meter).
Example: "12 Allen Avenue, Ikeja"
meter_type?string
Optional. PREPAID or POSTPAID. Detected from the meter when omitted.
Example: "PREPAID"
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.
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_electricity" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "disco_name": "IKEDC", "meter_no": "45031234567", "amount": 5000, "phone": "08031234567", "name": "ADEBAYO OLUWASEUN", "address": "12 Allen Avenue, Ikeja", "tranx_id": "ACME-20261121-000186" }'
Response example
{ "status": "success", "message": "Your Electricity Purchase To 45031234567 Was Successful... Thank You", "data": { "id": 81234, "tranx_status": 1, "order_id": "ACME-20261121-000184", "tranx_type": 19, "network": "IKEDC", "amount": "5000.00", "charge": "0.00", "phone": "45031234567", "balance_state": "{\"balance_before\":\"250,000.0000\",\"balance_after\":\"245,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, "token": "1234-5678-9012-3456-7890" } }