Cable Subscription

These Suit of APIs allow you vend cable subscriptions

This documentation site has been deprecated as of September 8, 2025, and will no longer receive updates. Please refer to the new documentation site at https://docs.squadco.com.

BOUQUET LIST

This API allows you to retrieve the bouquet list of a cable provider

POST https:{{base_url}}/v1/service/cable/bouquet-list

Request Body

Name
Type
Description

provider*

String

Name of Cable Provider (e.g, GoTV, DSTV)

Sample Request

{ 
    "provider": "GOTV"
}

Sample Response

{
    "status": 200,
    "success": true,
    "message": "Success",
    "data": {
        "bouquets": [
            {
                "name": "Smallie",
                "platform": "GOTV",
                "code": "GOLITE",
                "kobo_amount": 157500,
                "currency": "NGN",
                "provider": "GOTV"
            },
            {
                "name": "Jinja Bouquet",
                "platform": "GOTV",
                "code": "GOtvNJ1",
                "kobo_amount": 330000,
                "currency": "NGN",
                "provider": "GOTV"
            }
        ]
    }
}

ACCOUNT LOOKUP

This API allows you to look up the smartcard number of a provider before vending.

POST https:{{base_url}}/v1/service/cable/lookup

REQUEST BODY

Name
Type
Description

provider*

String

Name of Cable Provider (e.g, GoTV, DSTV)

smartcard_number*

String

The smartcard number of the decoder

Sample Request

{
    "provider": "GOTV",
    "smartcard_number": "4135391280"
}

Sample Response

{
    "status": 200,
    "success": true,
    "message": "Success",
    "data": {
        "reference": "MLTCHC-250228dd3bccb250f3ed1b",
        "customer_name": "ONYENULOYA"
    }
}

CABLE SUBSCRIPTION (VEND)

This API allows you to subscribe to a bouquet.

POST https:{{base_url}}/v1/service/cable/vend

Before vending, you must have first called the Account lookup endpoint, and pass the reference generated as your reference in order to vend

Request Body

Name
Type
Description

provider*

String

Name of Cable Provider (e.g, GoTV, DSTV)

reference*

String

Reference retrived from account lookup

boquet_code*

String

Provider's boquet package

phone_number*

String

Phone number of the user

email*

String

Email address of the user

Sample Request

{
    "provider": "GOTV",
    "reference": "MLTCHC-250228dd3bccb250f3ed1b",
    "bouquet_code": "GOTVMAX",
    "phone_number": "08061234567",
    "email": "cable@squadco.com"
}

Sample Response

{
    "status": 200,
    "success": true,
    "message": "Transaction in process, client will be notified",
    "data": {
        "reference": "MLTCHC-250228dd3bccb250f3ed1b",
        "bouquet": {
            "platform": "GOTV",
            "name": "Max Bouquet",
            "code": "GOTVMAX",
            "kobo_amount": 720000,
            "currency": "NGN",
            "provider": "GOTV"
        }
    }
}

PreviousUtilitiesNextElectricity Subscription

Last updated

Was this helpful?