Skip to main content
POST
/
api
/
v1
/
bills
/
buy-electricity
cURL
curl --request POST \
  --url https://api.dev.monei.cc/api/v1/bills/buy-electricity \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "meterNumber": "<string>",
  "amount": 123,
  "disco": "<string>",
  "isSchedule": true,
  "scheduleData": {
    "executionDate": "2023-11-07T05:31:56Z",
    "isRecurring": false,
    "recurrencePattern": "<string>"
  },
  "saveBeneficiary": false,
  "beneficiaryName": "<string>"
}
'
{
  "statusCode": 123,
  "message": "<string>",
  "data": {
    "id": "ee1c6018-ffce-49fa-a013-ada315e1e24d",
    "createdAt": "2025-10-03T20:07:17.157Z",
    "userId": "978e2b1c-edc7-4c67-bfcc-8438a0513f21",
    "reference": "bill1759522037109-978e2b1c-edc7-4c67-bfcc-8438a0513f21",
    "billerCode": "BIL102",
    "itemCode": "AT133",
    "customer": "09054860951",
    "amount": 50,
    "type": "AIRTIME",
    "status": "SUCCESS",
    "txRef": "CF-FLYAPI-20251003080718355562583",
    "billerName": "glo",
    "metadata": null,
    "token": null,
    "units": null,
    "validityPeriod": null
  },
  "errors": {}
}

Authorizations

X-API-KEY
string
header
required

Body

application/json
meterNumber
string
required
amount
number
required
disco
string
required
isSchedule
boolean
scheduleData
object
saveBeneficiary
boolean
default:false

Whether to save this beneficiary

beneficiaryName
string

Custom name for the beneficiary if saving

Response

default - application/json
statusCode
number
required
message
string
required
data
object
required

Bill payment transaction details

errors
object
required