List Electricity Providers

LIVE
Endpoint

Send a GET request to retrieve all electricity providers. No request body or query parameters are required.

Production URL
https://pairgate.com/api/v1/providers/electricity
Method GET
Test Endpoint
https://pairgate.com/api/v1/test/providers/electricity
Authentication

This request requires a valid Bearer token.

Header Value Description
Authorization
Bearer {token}
Your unique API authorization token
Code Examples

Choose your preferred language below. Replace YOUR_API_KEY with your actual API key.

PHP (Laravel)
// List Electricity Providers
$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_API_KEY',
    'Cache-Control' => 'no-cache',
])->get('https://pairgate.com/api/v1/providers/electricity');

$result = $response->json();

dd($result);
cURL
curl -X GET "https://pairgate.com/api/v1/providers/electricity" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Cache-Control: no-cache"
Node.js
const axios = require('axios');

const getElectricityProviders = async () => {
    try {
        const response = await axios.get(
            'https://pairgate.com/api/v1/providers/electricity',
            {
                headers: {
                    'Authorization': 'Bearer YOUR_API_KEY',
                    'Cache-Control': 'no-cache'
                }
            }
        );
        
        console.log(response.data);
    } catch (error) {
        console.error(error.response?.data || error.message);
    }
};

getElectricityProviders();
Python
import requests

url = "https://pairgate.com/api/v1/providers/electricity"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Cache-Control": "no-cache"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    data = response.json()
    print(data)
except requests.exceptions.RequestException as e:
    print(f"Error: {e}")
Java
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://pairgate.com/api/v1/providers/electricity"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Cache-Control", "no-cache")
    .GET()
    .build();

try {
    HttpResponse response = client.send(request, 
        HttpResponse.BodyHandlers.ofString());
    
    System.out.println(response.body());
} catch (Exception e) {
    System.err.println("Error: " + e.getMessage());
}
Response Format

A successful request returns a 200 status with an array of electricity distribution companies.

Success Response (200)
{
  "code": 200,
  "status": "success",
  "data": [
    {
      "id": "231fd51d-4e06-11f1-b9ca-98e8d4b7dfa9",
      "name": "Ikeja Electricity - IKEDC (PHCN)",
      "slug": "ikedc"
    },
    {
      "id": "231fd6ac-4e06-11f1-b9ca-98e8d4b7dfa9",
      "name": "Eko Electricity - EKEDC (PHCN)",
      "slug": "eko"
    },
    {
      "id": "231fd62e-4e06-11f1-b9ca-98e8d4b7dfa9",
      "name": "Enugu Electricity - EEDC",
      "slug": "enugu"
    }
  ]
}
Response Fields
Field Type Description
id string Provider UUID
name string Disco display name
slug string Short identifier for purchase and verification requests
Available Providers
Name Slug
Ikeja Electricity - IKEDC (PHCN) ikedc
Eko Electricity - EKEDC (PHCN) eko
Enugu Electricity - EEDC enugu
Yola Electricity - YEDC yola
Benin Electricity - BEDC benin
PortHarcourt Electricity - PHEDC ph
Aba Electricity - ABA aba
Abuja Electricity - AEDC aedc
Kaduna Electricity - KAEDC kaduna
Kano Electricity - KEDCO kedco
Ibadan Electricity - IBEDC ibedc
Jos Electricity - JEDC jedc
Error Responses

The following errors may occur when calling this endpoint.

Status Code Description
401 Missing API key No Bearer token provided
401 Invalid API key Token does not match any active key
403 Suspended API key or account has been suspended
429 Rate limited Too many requests