How to view a list of electricity utility billers available on Reloadly

Raphael Ugwu

July 13, 2022

< 1

Table of Contents

When trying to make an electricity bill payment with Reloadly’s Utility Payments API, it’s important to be aware of the utility biller base you can benefit from – the services they offer, and the countries they are located in. In this guide, you will learn how to view every electricity biller available in Reloadly. The steps that will be followed in this article are:

Getting your access token for the utility payment service
Getting details of all the utility billers within Reloadly

You can get your access token by following the steps in this quickstart

Getting details of all the utility billers within Reloadly

You can view details of every electricity utility biller by making a request to Reloadly’s Utility Payment API and specifying the keyword ELECTRICITY_BILL_PAYMENT as a query parameter. The cURL code snippet below shows how this can be done

curl -i -X GET \
  'https://utilities-sandbox.reloadly.com/billers?id=0&name=string&type=ELECTRICITY_BILL_PAYMENT&serviceType=string&countryISOCode=string&page=0&size=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

If successful, you will receive a JSON snippet with details of electricity billers

[
    {
      "id": 1,
      "name": "Ikeja Electricity Postpaid",
      "countryCode": "NG",
      "countryName": "Nigeria",
      "type": "ELECTRICITY_BILL_PAYMENT",
      "serviceType": "POSTPAID",
      "localAmountSupported": true,
      "localTransactionCurrencyCode": "NGN",
      "minLocalTransactionAmount": 1000,
      "maxLocalTransactionAmount": 300000,
      "localTransactionFee": 1184.61536,
      "localTransactionFeeCurrencyCode": "NGN",
      "localDiscountPercentage": 0,
      "internationalAmountSupported": true,
      "internationalTransactionCurrencyCode": "NGN",
      "minInternationalTransactionAmount": 1000,
      "maxInternationalTransactionAmount": 300000,
      "internationalTransactionFee": 1184.61536,
      "internationalTransactionFeeCurrencyCode": "NGN",
      "internationalDiscountPercentage": 0,
      "fx": {
        "rate": 1,
        "currencyCode": "NGN"
      }
    },
    {
      "id": 2,
      "name": "Abuja Electricity Postpaid",
      "countryCode": "NG",
      "countryName": "Nigeria",
      "type": "ELECTRICITY_BILL_PAYMENT",
      "serviceType": "POSTPAID",
      "localAmountSupported": true,
      "localTransactionCurrencyCode": "NGN",
      "minLocalTransactionAmount": 700,
      "maxLocalTransactionAmount": 300000,
      "localTransactionFee": 1184.61536,
      "localTransactionFeeCurrencyCode": "NGN",
      "localDiscountPercentage": 0,
      "internationalAmountSupported": true,
      "internationalTransactionCurrencyCode": "NGN",
      "minInternationalTransactionAmount": 700,
      "maxInternationalTransactionAmount": 300000,
      "internationalTransactionFee": 1184.61536,
      "internationalTransactionFeeCurrencyCode": "NGN",
      "internationalDiscountPercentage": 0,
      "fx": {
        "rate": 1,
        "currencyCode": "NGN"
      }
    }
  ]