> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monei.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Bills

> Tools for paying airtime, data, electricity, and cable TV bills

## get\_biller\_items

Returns available plans or packages for a specific biller with their item codes.

Call this before purchasing data bundles or cable TV subscriptions to get valid item codes. Data and cable purchases require an item code, not a raw amount.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| category | string | Yes | AIRTIME, MOBILEDATA, CABLEBILLS, or UTILITYBILLS |
| billerName | string | Yes | e.g. MTN, Airtel, Glo, 9mobile, DSTV, GOtv, Startimes |

```
"What MTN data plans are available?"
"Show me GOtv subscription packages"
```

***

## get\_electricity\_operators

Returns all supported electricity distribution companies with their disco codes.

Call this before paying an electricity bill to get the correct disco code for the user's provider.

```
"What electricity companies do you support?"
"What is the code for IKEDC?"
```

***

## validate\_bill\_customer

Validates a customer identifier such as a meter number or smartcard number before paying a bill.

Returns the customer name if the identifier is valid. Use this to confirm the right customer before completing a payment.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| customer | string | Yes | Meter number, smartcard number, or other identifier |
| billerCode | string | Yes | Biller code from discovery endpoints |
| itemCode | string | Yes | Item code from get\_biller\_items |

***

## buy\_airtime

Purchases airtime for any Nigerian phone number.

Confirm the phone number, network, and amount with the user before purchasing.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| phoneNumber | string | Yes | Nigerian phone number to recharge |
| biller | string | Yes | Network name — MTN, Airtel, Glo, or 9mobile |
| amount | number | Yes | Airtime amount in NGN |

```
"Buy ₦500 MTN airtime for 08012345678"
"Recharge 08098765432 with ₦1,000 Airtel airtime"
```

***

## buy\_mobile\_data

Purchases a mobile data bundle for a Nigerian phone number.

Always call `get_biller_items` first with category MOBILEDATA and the network name to get valid item codes. Data bundles use an item code, not a direct amount.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| phoneNumber | string | Yes | Nigerian phone number |
| biller | string | Yes | Network name — MTN, Airtel, Glo, or 9mobile |
| itemCode | string | Yes | Data plan code from get\_biller\_items |

```
"Buy an MTN data bundle for 08012345678"
"Get a 1GB Airtel data plan for 08098765432"
```

***

## pay\_electricity

Pays an electricity bill and generates a prepaid token for the meter.

**Required sequence:**

1. Call `get_electricity_operators` to get the correct disco code
2. Ask the user for their meter number and amount
3. Optionally call `validate_bill_customer` to confirm the meter is valid
4. Confirm details then pay

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| meterNumber | string | Yes | Prepaid meter number |
| amount | number | Yes | Amount in NGN to pay |
| disco | string | Yes | Electricity operator code e.g. IKEDC, EKEDC, AEDC, PHED |

```
"Pay ₦5,000 electricity for IKEDC meter 12345678901"
"Buy power units for my Eko Electricity meter"
```

***

## subscribe\_cable\_tv

Pays for a DSTV, GOtv, or Startimes subscription or renewal.

Always call `get_biller_items` with category CABLEBILLS and the provider name first to get valid item codes. Show the user available packages before subscribing.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| smartcardNumber | string | Yes | DSTV or GOtv smartcard or IUC number |
| biller | string | Yes | DSTV, GOtv, or Startimes |
| itemCode | string | Yes | Package code from get\_biller\_items |

```
"Renew my DSTV compact subscription, smartcard 1234567890"
"Subscribe GOtv Max for smartcard 0987654321"
```

***

## get\_bill\_history

Returns the user's recent bill payment history across all categories.

```
"Show my recent bill payments"
"What airtime have I bought this month?"
"Check my electricity payment history"
```