Skip to main content
GET
List Cable TV Bouquets

Overview

Retrieve the catalog of available bouquets and plans for Cable TV providers. You can optionally filter by provider network to get plans specific to DSTV, GOTV, etc.

Query Parameters

Response

The data field is an array of bouquet entries. Each entry contains the fields below.

Response Fields

number
Unique catalog item ID.
string
Cable TV provider for the package (e.g. DSTV, GOTV, STARTIMES).
string
Package code to submit as bouquetCode when purchasing.
string
Customer-readable bouquet or package name.
number
Package amount in Naira.
number
Customer commission rate for the package, when available.

Example Response

Notes

  • Use the returned productCode as the bouquetCode when purchasing a subscription.
  • Use the returned network as the provider when validating or purchasing.
  • Validate the smartcard before purchase so the customer can confirm their account details.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

network
string

Filter results by provider (e.g. DSTV, GOTV, STARTIMES)

Response

200 - application/json

Successfully retrieved cable tv bouquets

gatewayStatus
string
Example:

"00"

gatewayMessage
string
Example:

"Successfully Processed"

requestReference
string
Example:

"bpr_req_a1b2c3d4e5f6"

data
object[]