Welcome to the Fetch Internet Bundles List API Integration page. This guide will help you integrate our API to fetch a list of all active internet bundles on the Sandbox Vtunaija website, including each plan’s ID, name, price, validity, and other details.
curl -X POST https://sandbox.vtunaija.com.ng/api/listinternetbundlesplans/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
}'
{
"status": "success",
"Status": "successful",
"count": 47,
"internetbundles": [
{
"internetBundles_plan_id": 1,
"the_internetBundles_name": "SMILE",
"size": "1GB FlexiDaily for 1days - 450 Naira",
"the_internetBundles_type_name": "Smile",
"price_for_basicuser": "450.00",
"price_for_premiumuser": "450.00",
"commission_for_basicuser": "9.00",
"commission_for_premiumuser": "13.50",
"duration": "1days",
"status": "On"
},
{
"internetBundles_plan_id": 2,
"the_internetBundles_name": "SMILE",
"size": "2.5GB FlexiDaily for 2days - 750 Naira",
"the_internetBundles_type_name": "Smile",
"price_for_basicuser": "750.00",
"price_for_premiumuser": "750.00",
"commission_for_basicuser": "15.00",
"commission_for_premiumuser": "22.50",
"duration": "2days",
"status": "On"
},
{
"internetBundles_plan_id": 48,
"the_internetBundles_name": "SPECTRANET",
"size": "Spectranet ₦7000",
"the_internetBundles_type_name": "Spectranet",
"price_for_basicuser": "7000.00",
"price_for_premiumuser": "7000.00",
"commission_for_basicuser": "210.00",
"commission_for_premiumuser": "210.00",
"duration": "30",
"status": "On"
},
{
"internetBundles_plan_id": 49,
"the_internetBundles_name": "SPECTRANET",
"size": "Spectranet ₦10000",
"the_internetBundles_type_name": "Spectranet",
"price_for_basicuser": "10000.00",
"price_for_premiumuser": "10000.00",
"commission_for_basicuser": "300.00",
"commission_for_premiumuser": "300.00",
"duration": "30",
"status": "On"
}
]
}
This section shows the possible failed API responses and the scenarios when they will be returned. These responses are sent whenever something goes wrong with the API request, such as invalid input, missing API key, inactive account, or wrong request method.
{
"status": "fail",
"Status": "failed",
"message": "Invalid request method. Only POST requests are allowed."
}
- Returned when the request method is not POST.
{
"status": "fail",
"Status": "failed",
"message": "No input data received."
}
- Returned when the POST body is empty.
{
"status": "fail",
"Status": "failed",
"message": "Missing or invalid API key in Authorization header. Format: Authorization: Token {api_key}"
}
- Returned when the Authorization header is missing or incorrectly formatted.
{
"status": "fail",
"Status": "failed",
"message": "API key provided in the API request does not exist on our platform."
}
- Returned when the API key does not exist in the database.
{
"status": "fail",
"Status": "failed",
"message": "Your account is inactive. Please contact support."
}
- Returned when the user’s account status is inactive.
{
"status": "fail",
"Status": "failed",
"message": "Invalid JSON input."
}
- Returned when the POST body contains malformed or invalid JSON.