Welcome to the Fetch Cable TV Plans List API Integration page. This guide will help you integrate our API to fetch a list of all active cable tv plans 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/listcabletvplans/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
}'
{
"status": "success",
"Status": "successful",
"count": 96,
"cabletvplans": [
{
"cabletv_plan_id": 1,
"the_cabletv_name": "GOTV",
"size": "GOtv Smallie - monthly N1900",
"the_cabletv_type_name": "Gotv",
"price_for_basicuser": "1900.00",
"price_for_premiumuser": "1900.00",
"commission_for_basicuser": "15.20",
"commission_for_premiumuser": "22.80",
"duration": 30,
"status": "On"
},
{
"cabletv_plan_id": 2,
"the_cabletv_name": "GOTV",
"size": "GOtv Jinja N3,900",
"the_cabletv_type_name": "Gotv",
"price_for_basicuser": "3900.00",
"price_for_premiumuser": "3900.00",
"commission_for_basicuser": "31.20",
"commission_for_premiumuser": "46.80",
"duration": 30,
"status": "On"
},
{
"cabletv_plan_id": 6,
"the_cabletv_name": "DSTV",
"size": "DStv Padi N4,400",
"the_cabletv_type_name": "Dstv",
"price_for_basicuser": "4400.00",
"price_for_premiumuser": "4400.00",
"commission_for_basicuser": "35.20",
"commission_for_premiumuser": "52.80",
"duration": 30,
"status": "On"
},
{
"cabletv_plan_id": 7,
"the_cabletv_name": "DSTV",
"size": "DStv Yanga N6,000",
"the_cabletv_type_name": "Dstv",
"price_for_basicuser": "6000.00",
"price_for_premiumuser": "6000.00",
"commission_for_basicuser": "48.00",
"commission_for_premiumuser": "72.00",
"duration": 30,
"status": "On"
},
{
"cabletv_plan_id": 13,
"the_cabletv_name": "STARTIMES",
"size": "Nova (Dish) - 2100 Naira - 1 Month",
"the_cabletv_type_name": "Startimes",
"price_for_basicuser": "2100.00",
"price_for_premiumuser": "2100.00",
"commission_for_basicuser": "21.00",
"commission_for_premiumuser": "33.60",
"duration": 30,
"status": "On"
},
{
"cabletv_plan_id": 14,
"the_cabletv_name": "STARTIMES",
"size": "Basic (Antenna) - 4,000 Naira - 1 Month",
"the_cabletv_type_name": "Startimes",
"price_for_basicuser": "4000.00",
"price_for_premiumuser": "4000.00",
"commission_for_basicuser": "40.00",
"commission_for_premiumuser": "64.00",
"duration": 30,
"status": "On"
},
{
"cabletv_plan_id": 128,
"the_cabletv_name": "SHOWMAX",
"size": "Sports Mobile Only - 6 months - N24,000",
"the_cabletv_type_name": "Showmax",
"price_for_basicuser": "24000.00",
"price_for_premiumuser": "24000.00",
"commission_for_basicuser": "192.00",
"commission_for_premiumuser": "288.00",
"duration": 6,
"status": "On"
},
{
"cabletv_plan_id": 129,
"the_cabletv_name": "SHOWMAX",
"size": "Sports Only - 6 months - N18,200",
"the_cabletv_type_name": "Showmax",
"price_for_basicuser": "18200.00",
"price_for_premiumuser": "18200.00",
"commission_for_basicuser": "145.60",
"commission_for_premiumuser": "218.40",
"duration": 6,
"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.