How to fetch transaction data for all the bill payments made on your account

Raphael Ugwu

Raphael Ugwu

2 min

Keeping track of your bill payments is important, especially if you pay different bills for various services over an amount of time. This guide will walk you through how to achieve this. Steps to be followed in this guide are:

  • Getting your access token for the utility payment service
  • Retrieving your bill payment transaction details

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

Retrieving bill payment transaction details

Assuming you want to view bill payment transaction details for your account , you can achieve this by making a request to Reloadly’s Utility Payments API. The cURL code snippet below shows how you can achieve this:

curl -i -X GET \
  'https://utilities-sandbox.reloadly.com/transactions' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

If successful, you will receive a JSON snippet containing details of all the utility payments ever made on your account

{
    "content": [
      {
        "code": "PAYMENT_PROCESSED_SUCCESSFULLY",
        "message": "The payment was processed successfully",
        "transaction": {
          "id": 108,
          "status": "SUCCESSFUL",
          "referenceId": "may-electricity-bill",
          "amount": 1000,
          "amountCurrencyCode": "NGN",
          "deliveryAmount": 1000,
          "deliveryAmountCurrencyCode": "NGN",
          "fee": 1198.32797,
          "feeCurrencyCode": "NGN",
          "discount": 0,
          "discountCurrencyCode": "NGN",
          "submittedAt": "2022-07-05 12:28:07",
          "balanceInfo": {
            "oldBalance": 792671.04742,
            "newBalance": 790472.71945,
            "cost": 2198.32797,
            "currencyCode": "NGN",
            "currencyName": "Nigerian Naira",
            "updatedAt": "2022-07-05 16:28:07"
          },
          "billDetails": {
            "type": "ELECTRICITY_BILL_PAYMENT",
            "billerId": 5,
            "billerName": "Ikeja Electricity Prepaid",
            "billerCountryCode": "NG",
            "serviceType": "PREPAID",
            "completedAt": "2022-07-05 12:28:37",
            "subscriberDetails": {
              "accountNumber": "4223568280"
            },
            "pinDetails": {
              "token": "4836-2318-0748-3623-1807",
              "info1": null,
              "info2": null,
              "info3": null
            }
          }
        }
      },
      {
        "code": "PAYMENT_PROCESSED_SUCCESSFULLY",
        "message": "The payment was processed successfully",
        "transaction": {
          "id": 107,
          "status": "SUCCESSFUL",
          "referenceId": "april-electricity-bill",
          "amount": 1000,
          "amountCurrencyCode": "NGN",
          "deliveryAmount": 1000,
          "deliveryAmountCurrencyCode": "NGN",
          "fee": 1198.32797,
          "feeCurrencyCode": "NGN",
          "discount": 0,
          "discountCurrencyCode": "NGN",
          "submittedAt": "2022-07-05 10:55:03",
          "balanceInfo": {
            "oldBalance": 794869.37539,
            "newBalance": 792671.04742,
            "cost": 2198.32797,
            "currencyCode": "NGN",
            "currencyName": "Nigerian Naira",
            "updatedAt": "2022-07-05 14:55:03"
          },
          "billDetails": {
            "type": "ELECTRICITY_BILL_PAYMENT",
            "billerId": 5,
            "billerName": "Ikeja Electricity Prepaid",
            "billerCountryCode": "NG",
            "serviceType": "PREPAID",
            "completedAt": "2022-07-05 10:55:05",
            "subscriberDetails": {
              "accountNumber": "4223568280"
            },
            "pinDetails": {
              "token": "3717-9007-1537-1790-0715",
              "info1": null,
              "info2": null,
              "info3": null
            }
          }
        }
      }
    ],
    "pageable": {
      "sort": {
        "sorted": false,
        "unsorted": true,
        "empty": true
      },
      "pageNumber": 0,
      "pageSize": 20,
      "offset": 0,
      "unpaged": false,
      "paged": true
    },
    "totalPages": 1,
    "totalElements": 4,
    "last": true,
    "sort": {
      "sorted": false,
      "unsorted": true,
      "empty": true
    },
    "numberOfElements": 4,
    "first": true,
    "size": 20,
    "number": 0,
    "empty": false
  }

Resources

Reloadly API

Reloadly Developer Documentation

This might also interest you:

3 min
Gift cards have revolutionized the way we shop, reward, and engage customers. This article explores the key differences between open-loop and closed-loop gift cards—how open-loop cards offer universal flexibility while closed-loop cards drive brand loyalty. Understanding these distinctions can help businesses and consumers make smarter choices in the evolving digital payments landscape.
4 min
Building a startup is an all-consuming journey—one that requires deep financial knowledge, resilience in fundraising, empathy in leadership, strong sales skills, and a keen eye for hiring. Looking back, there are five things I wish I had known before launching my first company. From understanding cash flow and investor expectations to mastering the art of sales and team-building, these lessons could have saved me time, money, and stress. The early days demand total commitment, often at the cost of work-life balance, but that obsession is what it takes to succeed. If you're embarking on your own founder journey, these insights might just help you navigate the challenges ahead.

Content by developers to developers.

Subscribe to The Monthly Reload for Developers and start receiving all the developers’ updates.

The Monthly Reload: the newsletter for you

Subscribe to our Newsletter and don’t miss any news about our industry and products.

It’s time to build, make your first API call today