DTH Advance Information

Telecom
POST /api/v1/dth/info Bearer

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).

Availability

🗺 Country-specific

India

What DTH Advance Information Is Used For

Recharge amount guidance

Read the current balance, monthly amount and next recharge date to suggest what the customer should actually pay.

Retailer applications

Show account name, plan and status so a shop assistant can confirm the right connection before charging.

Dunning and reactivation

Use the switch-off date and account status to target subscribers before or just after disconnection.

Address confirmation

Use the installation address with city, district, state and pin code to confirm the connection you are servicing.

Quick Start

1. Copy your API key from Dashboard → API Keys
2. Send a POST request to /api/v1/dth/info
3. Pass the key as Authorization: Bearer <key>
4. Read the result from the data object in the JSON response

cURL

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"}'
🚀 Send Request
✓ Key saved

🔑 Remember API Key

One-click convenience for testing & troubleshooting — no account needed.

1

What it doesSaves your API key in this browser only using localStorage. Next time you open a docs page, the Try It panel is pre-filled automatically.

2

Auto-updatesIf you type a different key into any Try It field, the saved key is replaced instantly — only the most recent key is ever stored.

3

Uncheck to forgetUnchecking “Remember API Key” immediately deletes the stored key and clears the field. While unchecked, nothing is saved even if you type a new key.

4

Re-check to save againChecking the box again saves whatever key is currently in the Try It field.

⚠ Security note: Your key is stored only in your browser and is never sent to any server except as part of the actual API call you send. Do not use this feature on shared or public computers.

More on this API

Request Endpoint, authentication headers, every request parameter with its type, and a sample request body. Response The full success response payload, field by field. Error Codes HTTP status codes, error payload shape, and how to handle failures. Code Examples Ready-to-run examples in cURL, PHP, JavaScript and Python. Rate Limits Per-minute and per-day request limits, and what happens on breach. AI Agent / LLM The whole endpoint as one Markdown brief — paste into Claude, Cursor, Copilot or ChatGPT.