Welcome to the Cable TV Verification API Live Integration page. This guide will help you integrate our Live Cable Tv Verification API into your system.
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": "7512345678",
"request-id": "880jal8a87a0f"
}'
This is an example of the response returned for a successful Cable TV verification.
{
"Status": "successful",
"status": "success",
"api_response": "Cable Verification Name gotten successfully",
"id": "78977865523",
"ident": "78977865523",
"Customer_Name": "Adetunji Tunde",
"name": "Adetunji Tunde"
"Full_Details": "Customer_Name":"Adetunji Tunde","Status":"ACTIVE","Due_Date":"November 24th, 2024","Customer_Number":09012345678,"Customer_Type":"GOTV","Current_Bouquet":"GOtv Jinja N3,300","Renewal_Amount":3300"
}
This is an example of the response returned for a failed Cable TV verification.
{
"Status": "failed",
"status": "fail",
"api_response": "Cable Name Verification Failed",
"id": "78977865523",
"ident": "78977865523"
}
This is an example of a failed API response caused by factors such as an incorrect API key, missing POST fields, internal server errors and so on.
{
"Status": "failed",
"status": "fail",
"message": "Invalid request method. Only POST is allowed. The request method must be POST.",
}
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.
request-id: This is the unique ID you send as the Request ID.