Telecom API

DTH Advance Information

Pull the full subscriber profile behind a DTH customer ID / VC number.

DTH Advance Information
POST

DTH Advance Information API — Pull the full subscriber profile behind a DTH customer ID / VC number. Returns the account name, registered_mobile, current balance, monthly_amount, account status, plan, next_recharge_date, last_recharge_date, last_recharge_amount, switch_off_date and the installation address (with city, district, state and pin_code). Built for DTH recharge platforms and retailer apps that need to confirm the right account and its dues before taking a payment. Fields the operator does not publish for a given account are returned as empty strings (or "N/A" where the operator sends that).

  • Coverage: India
  • Real-time telecom lookup
  • Structured JSON response
  • POST request with Bearer auth
Get API Key — Free View Full Docs
Endpoint
POST
https://app.way2api.com/api/v1/dth/info

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
dth_number string Yes DTH subscriber / customer ID — 9 to 13 digits (e.g. 01234567890). The exact prefix and length are set by the operator and differ between them, so the operator rejects a well-formed ID that does not match its own scheme.
operator string Yes DTH operator of the connection. Accepted values: airtel_dth, dish_tv, reliance_bigtv, sun_direct, tata_play (alias tata_sky), videocon_d2h (alias d2h). Use the DTH Operator Check API if the operator is unknown.
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/dth/info", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "dth_number" => "01234567890", "operator" => "dish_tv" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/dth/info", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "dth_number": "01234567890", "operator": "dish_tv" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
curl -X POST https://app.way2api.com/api/v1/dth/info \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{\"dth_number\":\"01234567890\",\"operator\":\"dish_tv\"}'
$.ajax({ url: "https://app.way2api.com/api/v1/dth/info", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "dth_number": "01234567890", "operator": "dish_tv" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });
const { data } = await axios.post( "https://app.way2api.com/api/v1/dth/info", {"dth_number":"01234567890","operator":"dish_tv"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/dth/info", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "dth_number": "01234567890", "operator": "dish_tv" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "dth_number": "01234567890",
            "operator": "dish_tv",
            "customer_id": "9710835108",
            "name": "Thirugnanasamba",
            "registered_mobile": "97XXXXXX08",
            "balance": "194.73",
            "monthly_amount": "",
            "status": "1",
            "plan": "",
            "next_recharge_date": "8/4/2026 12:00:00 AM",
            "last_recharge_date": "N/A",
            "last_recharge_amount": "N/A",
            "switch_off_date": "8/7/2026 12:00:00 AM",
            "address": "pondy, VILLYANPUR, PONDICHERRY, Pin - 605110",
            "city": "PONDICHERRY",
            "district": "",
            "state": "PONDICHERRY",
            "pin_code": "605110"
        }
    }
}
4xx Error Response 
{
    "success": false,
    "message": "Customer Id Starts with 0 and is 11 digits long",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "1"
    }
}
Common Response Codes
Code Meaning
200 OK — Request successful
400 Bad Request — Missing or invalid parameters
401 Unauthorized — Invalid or missing API key
429 Too Many Requests — Rate limit exceeded
500 Server Error — Try again later
Ready to integrate?

Start with free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login