DTH Info

POST

/api/v1/recharge/dth-info

Validate DTH subscriber accounts and fetch customer details using the subscriber or smart card number. The API returns essential information such as subscriber name, account balance, and recharge status, allowing merchants to confirm account validity before processing a recharge. This improves user confidence and minimizes failed DTH transactions caused by incorrect subscriber inputs.

Request

Header Params

Body Params application/json

Example

{
    "ca_number": 3012345678,
    "operator_code": "12"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/recharge/dth-info' \
--header 'x-client-id: {{client_id}}' \
--header 'x-client-secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ca_number": 3012345678,
    "operator_code": "12"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "response_code": 200,
    "status": "success",
    "message": "DTH info fetched successfully",
    "data": {
        "ca_number": 3012345678,
        "operator": "Airteldth",
        "info": [
            {
                "Balance": 4.44,
                "customerName": "SATYANARAYANA SUNDRU",
                "NextRechargeDate": "2026-02-19",
                "status": "SUSPENDED",
                "planname": "Primary NCF,Hindi Basic HD 1M,Airtel Free Chnls Bundle_ROI,Airtel TV Premium",
                "MonthlyRecharge": 333
            }
        ]
    },
    "meta": {
        "request_id": "fdef8c78-ebc6-40c9-97bb-340ab2691ecb",
        "time": "2026-02-23T13:00:08+05:30"
    }
}

🟠422Validation Error

🟠401Unauthorized

HLR Check

Browse Plans