DTH Operator Check

POST

DTH Operator Check API — Identify which DTH operator a subscriber / customer ID belongs to, without asking the customer. Returns the machine-readable operator slug (e.g. sun_direct) plus the display operator_name. The returned slug is exactly the value the DTH Advance Information API expects, so the two chain together: identify the operator first, then pull the subscriber profile. Removes the most common cause of failed DTH recharges — the customer picking the wrong operator.

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/operator-check

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. 70512345661). Exact length depends on the operator.

Request Example

<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/dth/operator-check", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "dth_number" => "70512345661" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);

curl -X POST https://app.way2api.com/api/v1/dth/operator-check \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"dth_number":"70512345661"}'

$.ajax({ url: "https://app.way2api.com/api/v1/dth/operator-check", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "dth_number": "70512345661" }), 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/operator-check", {"dth_number":"70512345661"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);

import requests response = requests.post( "https://app.way2api.com/api/v1/dth/operator-check", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "dth_number": "70512345661" } ) print(response.status_code) print(response.json())

Response Example

200 OK Success Response

{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "dth_number": "70512345661",
            "operator": "sun_direct",
            "operator_name": "SUN DIRECT"
        }
    }
}

4xx Error Response

{
    "success": false,
    "message": "DTH operator could not be identified for this number",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "3"
    }
}

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 500 free trial calls on this API. No credit card required.

Get API Key — Free Browse All APIs

DTH Operator Check