Plan & Operator · Operator & Plans

DTH Plan Fetch

Fetch DTH pack / plan information

POST request

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

Body

{
    "opcode": "ATV",
    "orderid": "DTHP_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-plan-fetch" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "dth_number": "07210298754",
    "opcode": "ATV",
    "orderid": "DTHP_001"
}'

Success Response

{
    "fee": 0,
    "data": {
        "plans": {
            "AddOn": [
                {
                    "rs": 50,
                    "Type": "addon",
                    "desc": "Sample sports add-on (UAT)",
                    "validity": "30 Days"
                }
            ],
            "Combo": [
                {
                    "rs": 299,
                    "Type": "combo",
                    "desc": "Sample combo pack (UAT)",
                    "validity": "30 Days"
                },
                {
                    "rs": 499,
                    "Type": "combo",
                    "desc": "Sample HD combo pack (UAT)",
                    "validity": "30 Days"
                }
            ]
        },
        "orderid": "DTHP_001",
        "operator": "Airtel DTH"
    },
    "status": "success",
    "message": "UAT sample — DTH plans. 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 plan packs for the given operator and subscriber number.

UAT returns sample Combo / AddOn packs (fee = 0). Production hits the live aggregator.

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

DTH opcodes

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

Body

application/json required

DTH Plan Fetch 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": "DTHP_001",
    "dth_number": "07210298754"
}

Responses

200 · application/json default

Successful response

Example

{
    "fee": 0,
    "data": {
        "plans": {
            "AddOn": [
                {
                    "rs": 50,
                    "Type": "addon",
                    "desc": "Sample sports add-on (UAT)",
                    "validity": "30 Days"
                }
            ],
            "Combo": [
                {
                    "rs": 299,
                    "Type": "combo",
                    "desc": "Sample combo pack (UAT)",
                    "validity": "30 Days"
                },
                {
                    "rs": 499,
                    "Type": "combo",
                    "desc": "Sample HD combo pack (UAT)",
                    "validity": "30 Days"
                }
            ]
        },
        "orderid": "DTHP_001",
        "operator": "Airtel DTH"
    },
    "status": "success",
    "message": "UAT sample — DTH plans. Use production credentials for live aggregator data.",
    "wallet_balance": 1000
}

Rate Limits

60/min