Plan & Operator · Operator & Plans

DTH Customer Info

Fetch DTH customer info and account balance

POST request

URL: https://api.payorbit.in/api/v1/plan/dth-info

Body

{
    "opcode": "ATV",
    "orderid": "DTHI_001",
    "dth_number": "07210298754"
}

Include a valid Bearer token with every request

Code sample

curl -X POST "https://api.vizodigital.com/api/v1/plan/dth-info" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "dth_number": "07210298754",
    "opcode": "ATV",
    "orderid": "DTHI_001"
}'

Success Response

{
    "fee": 0,
    "data": {
        "orderid": "DTHI_001",
        "customer": [
            {
                "VC": "07210298754",
                "Name": "UAT Sample Customer",
                "Balance": "125.00",
                "Minimum_recharge": "200"
            }
        ]
    },
    "status": "success",
    "message": "UAT sample — DTH customer info. Use production credentials for live aggregator data.",
    "wallet_balance": 1000
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Fetches DTH customer name, balance, and minimum recharge for the given operator and subscriber number.

UAT returns sample customer info (fee = 0). Production hits the live aggregator.

Access & billing same as Operator Find (dth_info service key).

DTH opcodes

ATV — Airtel DTH
STV — Sun DTH
DTV — Dish TV
TTV — Tata Play
VTV — Videocon DTH

Body

application/json required

DTH Customer Info request body

Schema

{
    "type": "object",
    "required": [
        "dth_number",
        "opcode",
        "orderid"
    ],
    "properties": {
        "opcode": {
            "type": "string",
            "description": "DTH operator code, e.g. ATV"
        },
        "orderid": {
            "type": "string",
            "description": "Unique client order / request ID"
        },
        "dth_number": {
            "type": "string",
            "description": "DTH subscriber / VC number"
        }
    }
}

Example

{
    "opcode": "ATV",
    "orderid": "DTHI_001",
    "dth_number": "07210298754"
}

Responses

200 · application/json default

Successful response

Example

{
    "fee": 0,
    "data": {
        "orderid": "DTHI_001",
        "customer": [
            {
                "VC": "07210298754",
                "Name": "UAT Sample Customer",
                "Balance": "125.00",
                "Minimum_recharge": "200"
            }
        ]
    },
    "status": "success",
    "message": "UAT sample — DTH customer info. Use production credentials for live aggregator data.",
    "wallet_balance": 1000
}

Rate Limits

60/min