Fetch Cable TV Packages | VTUAgent

{
  "status": "successful",
  "status_code": 200,
  "message": "Cable TV variations fetched successfully",
  "data": {
    "product_type": "dstv",
    "packages": [
      {
        "package_code": "dstv-padi",
        "package_name": "DStv Padi",
        "price": "4400"
      },
      {
        "package_code": "dstv-yanga",
        "package_name": "DStv Yanga",
        "price": "6000"
      },
      {
        "package_code": "dstv-confam",
        "package_name": "DStv Confam",
        "price": "11000"
      },
      {
        "package_code": "dstv-compact",
        "package_name": "DStv Compact",
        "price": "19000"
      }
    ]
  }
}

Lists the bouquets available for a cable TV provider. Use the returned package_code and price in POST /v1/cabletv/purchase.

product_type is the provider service ID and is forwarded verbatim: dstv, gotv, startimes.

Authentication

AuthorizationBearer

API key issued from the VTUAgent dashboard, sent as Authorization: Bearer {your_api_key}.

Request

This endpoint expects an object.

product_typeenumRequired

Provider service ID, forwarded verbatim.

Allowed values:

Response

Packages fetched

statusenum

Allowed values:

status_codeenum

Allowed values:

messagestring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

424

Failed Dependency Error

500

Internal Server Error