This endpoint would allow you to retrieve saved information of bill airtime beneficiaries when purchasing Airtime with Pandascrow.

[GET] {{baseurl}}/v1/index/services/bills/fetch/beneficiaries

Fetch Beneficiaries

To retrieve beneficiaries' data for bill payment - airtime, you'll need to pass in the following parameters userID, network, and limit (optional).

Param

Required?

Description

type

userID

Yes

Provide userID a unique id issue to each registered user

Integer

network

Yes

Network is an integer 1 - 4, that covers MTN, Airtel, etc.)

Integer

limit

No

Used to limit number of request to receive.

Integer

API Object

{
    "status": 200,
    "data": {
        "beneficiaries": [
            {
                "billID": 2,
                "userID": 1,
                "phone": "08179000000",
                "name": "Precious Tom",
                "network": 4,
                "dateAdded": "Thu, 01 Sep 2022 01:50:03 +0000"
            },...
        ]
    }
}
curl -L -X GET '{{baseurl}}/v1/index/services/bills/fetch/beneficiaries' \
-H 'Content-Type: application/json' \
-H 'Authorization: SECRET_KEY'
-H 'Appid: appid'
Language
Click Try It! to start a request and see the response here!