Skip to main content
To use the Bills APIs in a live or production environment, Novac Payment uses IP whitelisting to grant access.
You’ll need to contact [email protected] to request access for your IP address.

​
Overview

The bills service providers API allows you to retrieve a list of all supported providers under different bill types such as airtime, data, and electricity. Each provider has a unique serviceId (or code) that you’ll use to initiate subsequent transactions — for example, purchasing airtime, data, or electricity tokens.
Always pass the correct type query parameter for example, airtime, data, or electricity to retrieve the right provider list for your integration.

​
Get Bill Service Providers by Type

Use this endpoint to fetch all available service providers for a specified bill type.
Each provider object includes its name, unique service code, and logo — which can be displayed to users when selecting a service to pay for.
Request
curl --request GET \
  --url https://integrations.novacpayment.com/api/v1/BillsPayment/providerdetailsbytype?type=airtime|data|electricity \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
Response
{
    "code": 200,
    "status": "success",
    "message": "Successful",
    "data": {
        "type": "airtime",
        "billsPaymentProviders": [
            {
                "name": "Airtel",
                "code": "A01E",
                "imageUrl": "https://res.cloudinary.com/dtld2ztim/image/upload/v1752065070/Airtel_upbjov.png"
            },
            {
                "name": "9mobile",
                "code": "A02E",
                "imageUrl": "https://res.cloudinary.com/dtld2ztim/image/upload/v1752065069/9Mobile_eso0n0.png"
            }
        ],
        "isSuccessful": true,
        "message": "Successful",
        "processingProvider": ""
    }
}
The type query parameter determines which set of providers is returned: airtime — returns all supported mobile network providers. data — returns all supported data service providers. electricity — returns all supported electricity distribution companies

​
What’s Next?

Learn how to purchase data, electricity or airtime using the follow APIs :