Bills — Electricity

Get Electricity Providers

GEThttps://backendapi.sayswitchgroup.com/api/v1/electricity

Retrieves a list of electricity distribution companies available for bill payment, along with their details including provider name, logo URL, and minimum payment amount.

Sample cURL Request

cURL
curl --request GET \
  --url "https://backendapi.sayswitchgroup.com/api/v1/electricity \
  --header 'Authorization: Bearer YOUR_SECRET_KEY'

Sample Response

JSON
{
  "success": true,
  "code": "00000",
  "message": "Fetched successfully",
  "data": [
    {
      "provider": "IKEDC",
      "code": "ikeja-electric",
      "providerLogoUrl": "assets/images/bills/Ikeja-Electric-Payment-PHCN.jpg",
      "minAmount": "500"
    },
    {
      "provider": "EKEDC",
      "code": "eko-electric",
      "providerLogoUrl": "assets/images/bills/Eko-Electric-Payment-PHCN.jpg",
      "minAmount": "500"
    },
    {
      "provider": "KEDCO",
      "code": "kano-electric",
      "providerLogoUrl": "assets/images/bills/Kano-Electric.jpg",
      "minAmount": "500"
    },
    {
      "provider": "PHED",
      "code": "portharcourt-electric",
      "providerLogoUrl": "assets/images/bills/Port-Harcourt-Electric.jpg",
      "minAmount": "500"
    },
    {
      "provider": "JED",
      "code": "jos-electric",
      "providerLogoUrl": "assets/images/bills/Jos-Electric-JED.jpg",
      "minAmount": "500"
    },
    {
      "provider": "IBEDC",
      "code": "ibadan-electric",
      "providerLogoUrl": "assets/images/bills/IBEDC-Ibadan-Electricity-Distribution-Company.jpg",
      "minAmount": "500"
    },
    {
      "provider": "KAEDCO",
      "code": "kaduna-electric",
      "providerLogoUrl": "assets/images/bills/Kaduna-Electric-KAEDCO.jpg",
      "minAmount": "500"
    },
    {
      "provider": "AEDC",
      "code": "abuja-electric",
      "providerLogoUrl": "assets/images/bills/Abuja-Electric.jpg",
      "minAmount": "500"
    }
  ]
}

Response Field

FieldTypeDescription
successbooleanIndicates if the request was successful
codestringAPI-specific response code
messagestringDescription of the response
dataarrayList of electricity providers
providerstringName of the electricity provider (e.g., IKEDC)
codestringUnique code used for referencing the provider
providerLogoUrlstringPath to the provider’s logo image
minAmountstringMinimum amount allowed for payment (in NGN)