Bills Payment

get

Authorizations

bearerapi-key

Path parameters

categorystring · enumRequiredPossible values:

billerNamestringRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

get

/api/v1/bills/get-biller-items/{category}/{billerName}

HTTPcURLJavaScriptPython

GET /api/v1/bills/get-biller-items/{category}/{billerName} HTTP/1.1
Host: api.monei.cc
Accept: */*

default

{
  "statusCode": 1,
  "message": "text",
  "data": [
    {
      "id": 17148,
      "biller_code": "BIL102",
      "name": "GLO VTU",
      "default_commission": 0.03,
      "date_added": "2022-09-19T18:27:55.327Z",
      "country": "NG",
      "is_airtime": true,
      "biller_name": "GLO VTU",
      "item_code": "AT133",
      "short_name": "GLO VTU",
      "fee": 0,
      "commission_on_fee": false,
      "reg_expression": "^[+]{1}[0-9]+$",
      "label_name": "Mobile Number",
      "amount": 0,
      "is_resolvable": true,
      "group_name": "Airtime",
      "category_name": "Airtime",
      "is_data": null,
      "default_commission_on_amount": 0.03,
      "commission_on_fee_or_amount": 2,
      "validity_period": null
    }
  ]
}

post

Authorizations

bearerapi-key

Body

application/json

itemCodestringRequired

customerstringRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

dataobjectRequired

post

/api/v1/bills/validate

HTTPcURLJavaScriptPython

POST /api/v1/bills/validate HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "itemCode": "text",
  "customer": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "data": {}
}

post

Authorizations

bearerapi-key

Body

application/json

isSchedulebooleanOptional

saveBeneficiarybooleanOptional

Whether to save this beneficiary

Default: false

beneficiaryNamestringOptional

Custom name for the beneficiary if saving

phoneNumberstringRequired

billerstringRequired

amountnumberRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

post

/api/v1/bills/buy-airtime

HTTPcURLJavaScriptPython

POST /api/v1/bills/buy-airtime HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 223

{
  "isSchedule": true,
  "scheduleData": {
    "executionDate": "2026-03-10T05:07:51.323Z",
    "isRecurring": false,
    "recurrencePattern": "text"
  },
  "saveBeneficiary": false,
  "beneficiaryName": "text",
  "phoneNumber": "text",
  "biller": "text",
  "amount": 1
}

default

{
  "statusCode": 1,
  "message": "text",
  "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
  }
}

post

Authorizations

bearerapi-key

Body

application/json

isSchedulebooleanOptional

saveBeneficiarybooleanOptional

Whether to save this beneficiary

Default: false

beneficiaryNamestringOptional

Custom name for the beneficiary if saving

phoneNumberstringRequired

billerstringRequired

itemCodestringRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

post

/api/v1/bills/buy-mobile-data

HTTPcURLJavaScriptPython

POST /api/v1/bills/buy-mobile-data HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 230

{
  "isSchedule": true,
  "scheduleData": {
    "executionDate": "2026-03-10T05:07:51.323Z",
    "isRecurring": false,
    "recurrencePattern": "text"
  },
  "saveBeneficiary": false,
  "beneficiaryName": "text",
  "phoneNumber": "text",
  "biller": "text",
  "itemCode": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "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
  }
}

post

Authorizations

bearerapi-key

Body

application/json

isSchedulebooleanOptional

saveBeneficiarybooleanOptional

Whether to save this beneficiary

Default: false

beneficiaryNamestringOptional

Custom name for the beneficiary if saving

meterNumberstringRequired

amountnumberRequired

discostringRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

post

/api/v1/bills/buy-electricity

HTTPcURLJavaScriptPython

POST /api/v1/bills/buy-electricity HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 222

{
  "isSchedule": true,
  "scheduleData": {
    "executionDate": "2026-03-10T05:07:51.323Z",
    "isRecurring": false,
    "recurrencePattern": "text"
  },
  "saveBeneficiary": false,
  "beneficiaryName": "text",
  "meterNumber": "text",
  "amount": 1,
  "disco": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "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
  }
}

post

Authorizations

bearerapi-key

Body

application/json

isSchedulebooleanOptional

saveBeneficiarybooleanOptional

Whether to save this beneficiary

Default: false

beneficiaryNamestringOptional

Custom name for the beneficiary if saving

smartcardNumberstringRequired

billerstringRequired

itemCodestringRequired

Responses

default

application/json

statusCodenumberRequired

messagestringRequired

post

/api/v1/bills/subscribe-cable-tv

HTTPcURLJavaScriptPython

POST /api/v1/bills/subscribe-cable-tv HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 234

{
  "isSchedule": true,
  "scheduleData": {
    "executionDate": "2026-03-10T05:07:51.323Z",
    "isRecurring": false,
    "recurrencePattern": "text"
  },
  "saveBeneficiary": false,
  "beneficiaryName": "text",
  "smartcardNumber": "text",
  "biller": "text",
  "itemCode": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "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
  }
}

get

Authorizations

bearerapi-key

Responses

default

application/json

idstringRequired

Unique identifier

createdAtstring · date-timeRequired

Record creation timestamp

updatedAtstring · date-timeRequired

Record last updated timestamp

deletedDatestring · date-timeRequired

Record deletion timestamp

userIdstringRequired

referencestringRequired

billerCodestringRequired

itemCodestringRequired

customerstringRequired

amountnumberRequired

typestring · enumRequiredPossible values:

statusstring · enumRequiredPossible values:

txRefstringOptional

billerNamestringOptional

validityPeriodstringOptional

metadatastringOptional

tokenstringOptional

unitsstringOptional

get

/api/v1/bills/history

HTTPcURLJavaScriptPython

GET /api/v1/bills/history HTTP/1.1
Host: api.monei.cc
Accept: */*

default

[
  {
    "id": "text",
    "createdAt": "2026-03-10T05:07:51.323Z",
    "updatedAt": "2026-03-10T05:07:51.323Z",
    "deletedDate": "2026-03-10T05:07:51.323Z",
    "userId": "text",
    "reference": "text",
    "billerCode": "text",
    "itemCode": "text",
    "customer": "text",
    "amount": 1,
    "type": "AIRTIME",
    "status": "PENDING",
    "txRef": "text",
    "billerName": "text",
    "validityPeriod": "text",
    "metadata": "text",
    "token": "text",
    "units": "text"
  }
]