Validate TV Smartcard

Developing

POST

/api/v1/public/validatetv

Confirms a DStv or GOtv smartcard number and returns the customer name, account status, due date and current bouquet. The wallet is debited ₦80 by default, or the company's custom TV fee, whenever VTPass answers, even when the smartcard is invalid. Provider outages are not charged and results are not cached.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Provider answered. Check data.isVerified, because a 200 does not mean the smartcard exists.

Bodyapplication/json

🟠400

🟠401

🔴500

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/public/validatetv' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "tvProvider": "DSTV",
    "smartCardNo": "7035421232"
}'

Response Example

200 - Success

{
    "status": true,
    "message": "Operation successful.",
    "data": {
        "isVerified": true,
        "message": "Smartcard number verified successfully.",
        "detail": "TRANSACTION SUCCESSFUL",
        "responseCode": "000",
        "referenceId": "5a7d9c10-2b4e-4d6a-8c31-7e0f1a2b3c4d",
        "transactionId": "4c8e1f0b7a2d4e6f9b3a5c7d1e0f2a4b",
        "verificationStatus": "verified",
        "data": {
            "smartCardNo": "7035421232",
            "tvProvider": "DSTV",
            "customerName": "JANE DOE",
            "status": "ACTIVE",
            "dueDate": "2026-11-01",
            "currentBouquet": "DStv Compact",
            "currentBouquetCode": "COMPA",
            "renewalAmount": "12500"
        },
        "billingInfo": {
            "wasCharged": true,
            "amount": "80",
            "currency": "NGN",
            "note": "TV smartcard validation charge"
        }
    }
}

Modified at 2026-10-13 19:14:01

Validate Meter Number

ApiResponse