Data Purchase

You can make a data bill payment purchase in three easy steps:

1. List the data providers

2. List the provider's details

3. Initiate the bill payment purchase

1. Get the list of data providers

Verb	URL
GET	{{baseUrl}}/api/bills/data/get_data_providers

To initiate data bill payment, make an API call to the list billers endpoint to fetch all the data providers’ details on Anchor. If this is successful, you will receive a list of all data providers on Anchor.

Sample request payload and sample 200 OK response payload are given below:

List Data Providers

curl --request GET \
     --url https://api.smarthivesms.com/api/data/get_data_providers \
     --header 'accept: application/json' \
     --header 'x-api-key: <API KEY>'

200 OK Response

{
    "status": "ok",
    "description": "The request has succeeded",
    "data": [
        {
            "provider_id": "168322497971130-anc_blr",
            "type": "Provider",
            "attributes": {
                "name": "MTN",
                "category": "data",
                "slug": "mtn"
            }
        },
        {
            "provider_id": "168322497841229-anc_blr",
            "type": "Provider",
            "attributes": {
                "name": "GLO",
                "category": "data",
                "slug": "glo"
            }
        },
        {
            "provider_id": "168322497720128-anc_blr",
            "type": "Provider",
            "attributes": {
                "name": "Airtel",
                "category": "data",
                "slug": "airtel"
            }
        },
        {
            "provider_id": "168322497484826-anc_blr",
            "type": "Provider",
            "attributes": {
                "name": "9Mobile",
                "category": "data",
                "slug": "9mobile"
            }
        },
        {
            "provider_id": "16832249694660-anc_blr",
            "type": "Provider",
            "attributes": {
                "name": "NTEL",
                "category": "data",
                "slug": "ntel"
            }
        }
    ]
}

2. Get the provider’s details

Verb	URL
GET	{{baseUrl}}/api/bills/data/get_data_products?providerId={providerId}

Then call the list biller product endpoint and pass the providerId to fetch all the Products of that provider. When you list the biller product, note the slug and price of the data product you want to purchase as you will use this in creating the data bill payment.

price - price of the of the data bundle specified in the countries lowest currency unit. Price is a fixed for data

providerId is the unique Id of the bill provider.

slug is the human readable identifier of the data product/plan. When you list a biller product you will see the product slug on each biller product.

Sample request payload and sample 200 OK response payload are given below:

List Provider Details

curl --request GET \
     --url https://api.smarthivesms.com/api/data/get_data_products?billerId=168322497175013-anc_blr \
     --header 'accept: application/json' \
     --header 'x-api-key: <API KEY>'

200 OK Response

{
    "status": "ok",
    "description": "The request has succeeded",
    "data": [
        {
            "product_id": "168322497184638-anc_bll_itm",
            "provider_id": "168322497175013-anc_blr",
            "type": "Airtime",
            "attributes": {
                "price": {
                    "type": "Range",
                    "minimumAmount": 1000,
                    "maximumAmount": 5000000,
                    "currency": "NGN"
                },
                "name": "10-50000 NGN Top Up",
                "slug": "glo_10_50000_ngn_top_up"
            }
        },
        {
            "product_id": "168322497199742-anc_bll_itm",
            "provider_id": "168322497175013-anc_blr",
            "type": "Airtime",
            "attributes": {
                "price": {
                    "type": "Range",
                    "minimumAmount": 1000,
                    "maximumAmount": 5000000,
                    "currency": "NGN"
                },
                "name": "10-50000 NGN PIN",
                "slug": "glo_10_50000_ngn_pin"
            }
        }
    ]
}

3. Initiate the data bill payment:

Verb	URL
POST	{{baseUlr}}/api/bills/data/get_data

When you have identified the data bundle you want to purchase, you can proceed to purchase the identified data plan.

Attribute	Description
phoneNumber	This is the phone number that will receive the data bundle.
amount	This is the fixed amount of the data bundle (specified in the currencies lowest denomination).
productSlug	The slug of the product for which the payment is being made.
reference	The unique identifier of the transaction on your system.

Initiate Data Purchase

curl --location 'http://localhost:6008/api/bills/data/get_data' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <API KEY>' \
--data '{
    "phoneNumber": "23490XXXXXXX",
    "amount": 10000,
    "productSlug": "mtn_dataplan_100mb_daily_24_hours_",
    "reference": 3456789
}'

200 OK Response

{
    "status": "ok",
    "description": "The request has succeeded",
    "data": {
        "transaction_id": "6888f399f765c6d3e4693a38",
        "product_id": "17538057218490-anc_bll",
        "type": "BillPayment",
        "attributes": {
            "reference": "345678990988998660",
            "createdAt": "2025-07-29T16:15:21.856142408",
            "amount": 10000,
            "phoneNumber": "2349066290713",
            "detail": {
                "provider": "MTN",
                "product": "DataPlan 100MB Daily (24 Hours)",
                "units": 0
            },
            "category": "data",
            "commissionAmount": 0,
            "status": "COMPLETED",
            "updatedAt": "2025-07-29T16:15:21.876935883"
        }
    }
}