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

# Get Electricity Providers

> Fetch all active electricity distribution companies (DISCOs) and their convenience fees.

## Request

**Authorization** `string` *required*

Bearer token: `Bearer <api-key>`

```bash cURL theme={null}
curl --request GET \
  --url https://api.rapidtopup.com.ng/api/v2/b2b/services/electricity \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api-key>'
```

```javascript JavaScript (Fetch) theme={null}
const response = await fetch('https://api.rapidtopup.com.ng/api/v2/b2b/services/electricity', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer <api-key>',
  },
});

const data = await response.json();
// data.data = array of DISCO objects with service_id, name, convenience_fee
```

```php PHP (Guzzle) theme={null}
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://api.rapidtopup.com.ng/api/v2/b2b/services/electricity', [
    'headers' => [
        'Accept'        => 'application/json',
        'Authorization' => 'Bearer <api-key>',
    ],
]);

$data = json_decode($response->getBody(), true);
// $data['data'] = array of DISCOs with service_id, name, convenience_fee
```

***

## Response

**status** `string`

`success`

**data** `array`

Array of provider objects, each containing:

**Provider object fields**

**service\_id** `string`

Use this as `service_id` in your `/purchase` request. E.g. `"ikeja-electric"`

**name** `string`

Human-readable DisCo name. E.g. `"Ikeja Electric"`

**convenience\_fee** `number`

The flat convenience fee added to electricity purchases for this provider in NGN.

**✅ Success `200`:**

```json theme={null}
{
  "status": "success",
  "data": [
    { "service_id": "ikeja-electric",       "name": "Ikeja Electric", "convenience_fee": 100.00 },
    { "service_id": "eko-electric",         "name": "Eko Electric", "convenience_fee": 100.00 },
    { "service_id": "abuja-electric",       "name": "Abuja Electric (AEDC)", "convenience_fee": 100.00 },
    { "service_id": "kano-electric",        "name": "Kano Electric", "convenience_fee": 100.00 },
    { "service_id": "portharcourt-electric","name": "Port Harcourt Electric", "convenience_fee": 100.00 },
    { "service_id": "jos-electric",         "name": "Jos Electric", "convenience_fee": 100.00 },
    { "service_id": "benin-electric",       "name": "Benin Electric", "convenience_fee": 100.00 },
    { "service_id": "enugu-electric",       "name": "Enugu Electric", "convenience_fee": 100.00 },
    { "service_id": "yola-electric",        "name": "Yola Electric", "convenience_fee": 100.00 },
    { "service_id": "kaduna-electric",      "name": "Kaduna Electric", "convenience_fee": 100.00 },
    { "service_id": "ibadan-electric",      "name": "Ibadan Electric", "convenience_fee": 100.00 }
  ]
}
```

***

## Meter Types

When calling `POST /purchase` for electricity, use one of these `variation_code` values:

| variation\_code | Description |
| - | - |
| `prepaid` | Prepaid meter — returns a token in the response |
| `postpaid` | Postpaid meter — pays outstanding bill |

> [!WARNING]
>
> Electricity purchases require a **mandatory two-step verification**. Call [`GET /services/verify`](https://docs.rapidtopup.com.ng/api-reference/verify) with the meter number before proceeding to `/purchase`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.