List Electricity Providers
LIVEQuick Summary
Returns all active electricity distribution companies (Discos) available on the Pairgate platform. Use this endpoint to get provider slugs needed for meter verification and electricity purchases.
Endpoint
Send a GET request to retrieve all electricity providers. No request body or query parameters are required.
https://pairgate.com/api/v1/providers/electricity
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.
// 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 -X GET "https://pairgate.com/api/v1/providers/electricity" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Cache-Control: no-cache"
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();
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}")
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 |