> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rapidtopup.com.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Cable TV Plans

> Fetch all active cable TV providers, bouquet subscription plans, convenience fees, and validity periods.

## Request

**Authorization** `string` *required*

Bearer token: `Bearer <api-key>`

```bash cURL theme={null}
curl --request GET \
  --url https://api.rapidtopup.com.ng/api/v2/b2b/services/cable \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api-key>'
```

```javascript JavaScript (Fetch) theme={null}
const response = await fetch('https://api.rapidtopup.com.ng/api/v2/b2b/services/cable', {
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer <api-key>',
  },
});

const data = await response.json();
// data.data = array of provider objects with plans and convenience_fee
```

```php PHP (Guzzle) theme={null}
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://api.rapidtopup.com.ng/api/v2/b2b/services/cable', [
    'headers' => [
        'Accept'        => 'application/json',
        'Authorization' => 'Bearer <api-key>',
    ],
]);

$data = json_decode($response->getBody(), true);
// $data['data'] = array of providers with plans
```

***

## Response

**status** `string`

`success`

**data** `array`

Array of provider objects, each containing:

**Provider object fields**

**provider** `string`

Human-readable provider name. E.g. `"DStv"`, `"GOtv"`, `"Startimes"`

**service\_id** `string`

Use this as `service_id` in your `/purchase` request. E.g. `"dstv"`, `"gotv"`, `"startimes"`

**convenience\_fee** `number`

The flat convenience fee added to purchases for this provider in NGN.

**plans** `array`

**Plan object fields**

**variation\_code** `string`

Use this as `variation_code` in your `/purchase` request. E.g. `"rapid_cable_001"`

**name** `string`

Human-readable bouquet name. E.g. `"DStv Padi"`

**variation\_amount** `number`

The discounted reseller cost price in NGN deducted from your wallet (excluding convenience fee).

**validity** `string`

Plan validity period. E.g. `"30 DAYS"`

**✅ Success `200`:**

```json theme={null}
{
  "status": "success",
  "data": [
    {
      "provider": "DStv",
      "service_id": "dstv",
      "convenience_fee": 100.00,
      "plans": [
        {
          "service_id": "dstv",
          "variation_code": "rapid_cable_001",
          "name": "DStv Padi",
          "variation_amount": 2870.00,
          "validity": "30 DAYS"
        },
        {
          "service_id": "dstv",
          "variation_code": "rapid_cable_002",
          "name": "DStv Compact",
          "variation_amount": 8750.00,
          "validity": "30 DAYS"
        }
      ]
    },
    {
      "provider": "GOtv",
      "service_id": "gotv",
      "convenience_fee": 100.00,
      "plans": [
        {
          "service_id": "gotv",
          "variation_code": "rapid_cable_003",
          "name": "GOtv Smallie",
          "variation_amount": 1530.00,
          "validity": "30 DAYS"
        }
      ]
    },
    {
      "provider": "Startimes",
      "service_id": "startimes",
      "convenience_fee": 100.00,
      "plans": [
        {
          "service_id": "startimes",
          "variation_code": "rapid_cable_005",
          "name": "Startimes Nova",
          "variation_amount": 875.00,
          "validity": "30 DAYS"
        }
      ]
    }
  ]
}
```

> [!WARNING]
>
> Cable TV purchases require a **mandatory two-step verification**. Call [`GET /services/verify`](https://docs.rapidtopup.com.ng/api-reference/verify) with the smartcard number first. Display the resolved customer name to your user and only proceed to `/purchase` after they confirm it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.