× Integration Introduction page Airtime API Documentation Data API Documentation Cable TV API Documentation Electricity API Documentation Bulk SMS API Documentation Data Pin API Documentation Exam Pin API Documentation Internet Bundles API Documentation Recharge Card Pin API Documentation

Cable TV Verification API Integration

(Live Environment)

This guide will help you integrate our Cable Tv Verification API into your system.

cURL Init Sample

curl -X POST https://vtunaija.com.ng/api/cablesub/verify/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"cablename": "1",
"smart_card_number": "289645439"
}'

Successful API Response

{
"Status": "successful",
"status": "success",
"api_response": "Cable Verification Name gotten successfully",
"id": "78977865523",
"ident": "78977865523",
"Customer_Name": "Stella Akonaiki",
"name": "Stella Akonaiki"
"Full_Details": "Customer_Name":"Stella Akonaiki","Status":"SUSPENDED","Due_Date":"November 24th, 2024","Customer_Number":289645439,"Customer_Type":"GOTV","Current_Bouquet":"GOtv Jinja N3,300","Current_Bouquet_Code":"gotv-jinja","Renewal_Amount":3300"
}

Failed API Response

{
"Status": "failed",
"status": "fail",
"api_response": "Cable Name Verification Failed",
"id": "78977865523",
"ident": "78977865523"
}

Cable TV API Integration

(Live Environment)

Welcome to the Cable TV API Integration page. This guide will help you integrate our Cable Tv API into your system.

cURL Init Sample

curl -X POST https://vtunaija.com.ng/api/cablesub/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"cablename": "1",
"smart_card_number": "289645439",
"cableplan": "3"
}'

Successful API Response

{
"Status": "successful",
"status": "success",
"api_response": "TRANSACTTION SUCCESSFUL",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "5800"
}

Failed API Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "0"
}

Post Terms Defined and Interpreted

cablename: This identifies the specific cable tv provider for which the user is subscribing cable tv. The cablename post field is represented by the numbers 1, 2, 3, or 4: 1 indicates GOTV, 2 indicates DSTV, 3 indicates STARTIMES, and 4 indicates SHOWMAX. For the complete list of Vtunaija Cable IDs and Plan IDs, check the API Documentation Page 1.

smart_card_number: This is the IUC number or ICU number or Phone Number of the Cable tv for which the user wants to subscribe. For Gotv or Dstv it is IUC number, While for Startimes it is ICU number, but for Showmax it is Phone number.

cableplan: This is the particular cable tv package that the user wants to buy. The different cable tv packages are represented by Plan IDs. For the complete list of Vtunaija Network IDs and Plan IDs, check the API Documentation Page 1.