My DishTV data API: packs, balance and recharge
My DishTV is the subscriber self-care app from Dish TV India Limited, the Indian direct-to-home satellite television operator behind the DishTV and d2h brands, serving prepaid DTH households across India alongside rivals such as Tata Play and Airtel Digital TV. Subscribers sign in with their registered mobile number and an SMS one-time password, the same credentials as My Account on the DishTV website, then switch between the DishTV, d2h and Smart+ boxes linked to that number. The home dashboard shows the wallet balance, the monthly recharge amount and the date the service will switch off, and Instant Recharge tops up a box for oneself, for a friend or on pay-later, checking out through Juspay with Amazon Pay and PhonePe options. Manage My Pack lists the current bouquet channel by channel and lets viewers browse recommended packs, Dish TV combos, value packs and a-la-carte channels by genre and language before adding or dropping channels and add-ons. Account Statement, All Transactions and My Invoice keep recharge history and downloadable tax invoices in one place; the Channel Guide carries programme listings with synopses, favourites and reminders; home banners surface limited-time recharge offers, including tie-ins with Dish TV's Watcho streaming service; and Issue Tracker logs no-signal, recharge-not-reflected and set-top-box faults with step-by-step troubleshooting.
Viewing-card connections are the unit everything hangs on: a vcNumber paired with its stbId set-top box and brand (DishTV, d2h or Smart+), grouped under one subscriberId and subscriberName for the registered mobile number. Each connection carries a live INR wallet position — balanceAmount, monthlyRechargeAmount, switchOffDate, lastPaymentDate and lastPaymentAmount — plus accountStatus and the currentPack with its packId, packType and endDate.
The lineup is recorded row by row: the subscribed bouquet reports monthlyPrice, hdEnabled and channelCount, every channel row carries channelId, channelName, genre, language, quality, its lcn and an isAlaCarte flag, and paid addOns are listed separately. The pack catalog adds priced recommended bouquets, combos and alaCarte channels, while pack changes return newMonthlyPrice, priceDelta and effectiveFrom.
Money moves through three linked records: recharge orders (amount, offerId, discountAmount, payableAmount, payLater, rechargeForFriend, juspayOrderId and the projected switchOffDateAfter), the account-statement ledger (txnId, txnDate, txnType, mode, status, narration) and invoices (invoiceNumber, periodFrom, periodTo, GST taxAmount, totalAmount, pdfUrl). Offers add discountType, discountValue, minRechargeAmount, validTill and applicablePackIds.
Programme-guide rows give programmeId, title, startTime, endTime and synopsis per lcn, with per-viewer isFavorite and reminderSet flags; service tickets record category, errorCode, ticketId, ticketStatus, etaHours and troubleshootSteps for each box fault.
Household-billing bots watch balanceAmount and switchOffDate per connection and suggest monthlyRechargeAmount as the top-up before the box goes dark; content-rights dashboards diff the channels and add-ons a viewing card actually carries against the catalog's bouquets and a-la-carte rows; nightly finance jobs land txnId, mode, payableAmount and GST taxAmount into an INR cashbook matched to the Juspay order; and companion clients turn subscribed-channel EPG rows into reminders that mirror the Channel Guide. openData Studio makes these DishTV connection, lineup, ledger and guide records callable open data for exactly those integrations.
Screenshots
API surface
Request/response examples are illustrative, reconstructed from the app's interface — not a live capture.
Send login OTP to registered mobile
POST
/api/SubApp/auth/otposintStarts My DishTV login by sending a 6-digit SMS OTP to the subscriber's registered mobile number (RMN) and returns the otpTxnId used to confirm it.
Auth: Unauthenticated. Body is the registered mobile number (RMN). The native encryption plugin JWT-signs the payload. On success an otpTxnId is required by the verify step.
- rmn
- channel
- appVersion
- platform
- status
- message
- otpTxnId
- otpLength
- resendAfterSeconds
- maskedRmn
POST /api/SubApp/auth/otp HTTP/1.1 Content-Type: application/json X-App-Version: 10.1.9 { "rmn": "9876543210", "channel": "SMS", "appVersion": "10.1.9", "platform": "android" }{ "status": "SUCCESS", "message": "OTP sent", "otpTxnId": "otp-7c11e2", "otpLength": 6, "resendAfterSeconds": 30, "maskedRmn": "98XXXX3210" }Verify OTP and issue subscriber session
POST
/api/SubApp/auth/verifyosintConfirms the SMS OTP and returns the Bearer session plus the list of viewing-card connections linked to the RMN (DishTV / d2h / Smart+ boxes).
Auth: Unauthenticated. Body carries otpTxnId from /api/SubApp/auth/otp plus the SMS code. The returned accessToken is sent as Authorization: Bearer on later SubApp calls.
- otpTxnId
- otp
- rmn
- status
- accessToken
- refreshToken
- subscriberId
- subscriberName
- connections
- vcNumber
- stbId
- brand
- tokenType
POST /api/SubApp/auth/verify HTTP/1.1 Content-Type: application/json X-App-Version: 10.1.9 { "otpTxnId": "otp-7c11e2", "otp": "482913", "rmn": "9876543210" }{ "status": "SUCCESS", "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session", "refreshToken": "rt-dishtv-9f2a", "subscriberId": "SUB-18482911", "rmn": "9876543210", "subscriberName": "Rahul Sharma", "connections": [ { "vcNumber": "012345678901", "stbId": "STB88421", "brand": "DISHTV", "status": "ACTIVE" } ], "tokenType": "Bearer" }Fetch account summary (balance, pack, switch-off)
GET
/api/SubApp/account/summaryopenbankingLoads the home dashboard: viewing-card identity, INR wallet balance, monthly recharge amount, switch-off date and the currently subscribed bouquet.
Auth: Authorization: Bearer accessToken from /api/SubApp/auth/verify. Query vcNumber selects the active connection when the RMN has more than one box.
- vcNumber
- stbId
- subscriberName
- accountStatus
- balanceAmount
- currency
- monthlyRechargeAmount
- switchOffDate
- lastPaymentDate
- lastPaymentAmount
- currentPack
- packId
- packName
- packType
- endDate
GET /api/SubApp/account/summary?vcNumber=012345678901 HTTP/1.1 Authorization: Bearer eyJhbGciOi... X-App-Version: 10.1.9{ "status": "SUCCESS", "vcNumber": "012345678901", "stbId": "STB88421", "subscriberName": "Rahul Sharma", "accountStatus": "ACTIVE", "balanceAmount": 186.50, "currency": "INR", "monthlyRechargeAmount": 399.00, "switchOffDate": "2026-10-12", "lastPaymentDate": "2026-09-12", "lastPaymentAmount": 399.00, "currentPack": { "packId": "PK-SUPER-FAMILY-HINDI", "packName": "Super Family Hindi", "packType": "BOUQUET", "endDate": "2026-10-12" } }List current pack and subscribed channels
GET
/api/SubApp/packs/currentopendataReturns the subscribed bouquet, per-channel LCN/genre/language/quality rows and paid add-ons shown on Manage My Pack.
Auth: Authorization: Bearer accessToken. vcNumber query selects the box.
- vcNumber
- packId
- packName
- packType
- monthlyPrice
- hdEnabled
- channelCount
- channels
- channelId
- channelName
- genre
- language
- quality
- lcn
- isAlaCarte
- addOns
- addOnId
- addOnName
GET /api/SubApp/packs/current?vcNumber=012345678901 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "vcNumber": "012345678901", "packId": "PK-SUPER-FAMILY-HINDI", "packName": "Super Family Hindi", "packType": "BOUQUET", "monthlyPrice": 399.00, "hdEnabled": true, "channelCount": 312, "channels": [ { "channelId": "CH-101", "channelName": "Star Plus", "genre": "GEC", "language": "Hindi", "quality": "HD", "lcn": 101, "isAlaCarte": false } ], "addOns": [ { "addOnId": "AO-SPORTS-HD", "addOnName": "Sports HD", "monthlyPrice": 49.00 } ] }Search recommended packs and a-la-carte channels
GET
/api/SubApp/packs/catalogopendataPages the pack catalog used by Manage My Pack: recommended bouquets, Dish TV combos, value packs and a-la-carte channels filterable by genre and language.
Auth: Authorization: Bearer accessToken. Optional genre, language and q filters from the pack browser.
- genre
- language
- q
- recommended
- packId
- packName
- packType
- monthlyPrice
- channelCount
- isRecommended
- combos
- alaCarte
- channelId
- channelName
GET /api/SubApp/packs/catalog?vcNumber=012345678901&genre=GEC&language=Hindi&q=family HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "recommended": [ { "packId": "PK-VALUE-HINDI", "packName": "Value Hindi", "packType": "VALUE_PACK", "monthlyPrice": 249.00, "channelCount": 198, "isRecommended": true } ], "combos": [ { "packId": "PK-DISH-COMBO-1", "packName": "Dish TV Combo", "monthlyPrice": 449.00 } ], "alaCarte": [ { "channelId": "CH-401", "channelName": "Sony Liv Pack", "monthlyPrice": 19.00, "language": "Hindi" } ] }Modify pack (add or drop channels)
POST
/api/SubApp/packs/modifyopendataApplies add/drop channel and add-on changes on Manage My Pack and, when the monthly price rises, returns a paymentOrderId handed to the recharge checkout.
Auth: Authorization: Bearer accessToken. Write against the selected vcNumber; a preview quote is returned before payment if the monthly price changes.
- vcNumber
- addChannelIds
- removeChannelIds
- addOnIds
- modificationId
- newMonthlyPrice
- priceDelta
- effectiveFrom
- requiresPayment
- paymentOrderId
POST /api/SubApp/packs/modify HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "vcNumber": "012345678901", "addChannelIds": ["CH-401"], "removeChannelIds": ["CH-218"], "addOnIds": ["AO-SPORTS-HD"] }{ "status": "SUCCESS", "modificationId": "MOD-55291", "vcNumber": "012345678901", "newMonthlyPrice": 448.00, "priceDelta": 49.00, "effectiveFrom": "2026-10-13", "requiresPayment": true, "paymentOrderId": "pay-8f21a4" }Initiate instant recharge
POST
/api/SubApp/recharge/initiateopenfinanceCreates a DishTV recharge order for the selected VC (self, friend or pay-later), applies an offer, and returns the Juspay order used by the in-app checkout.
Auth: Authorization: Bearer accessToken. Amount defaults to monthlyRechargeAmount from the account summary; Juspay HyperSDK completes the instrument step.
- vcNumber
- amount
- currency
- offerId
- payLater
- rechargeForFriend
- orderId
- discountAmount
- payableAmount
- juspayClientId
- juspayOrderId
- paymentUrl
- switchOffDateAfter
POST /api/SubApp/recharge/initiate HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "vcNumber": "012345678901", "amount": 399.00, "currency": "INR", "offerId": "OFF-FESTIVE-50", "payLater": false, "rechargeForFriend": false }{ "status": "SUCCESS", "orderId": "DTV-RCH-884291", "vcNumber": "012345678901", "amount": 399.00, "discountAmount": 50.00, "payableAmount": 349.00, "currency": "INR", "juspayClientId": "dishtv", "juspayOrderId": "ordeh_9c1a", "paymentUrl": "https://payments.juspay.in/merchant/pay/ordeh_9c1a", "switchOffDateAfter": "2026-11-12" }List account statement / recharge transactions
GET
/api/SubApp/transactionsopenbankingPages the account-statement ledger behind All Transactions: recharge, pack-modify and pay-later rows with mode, status and narration.
Auth: Authorization: Bearer accessToken. Paginated by fromDate / toDate and vcNumber.
- fromDate
- toDate
- page
- pageSize
- total
- transactions
- txnId
- txnDate
- txnType
- amount
- currency
- mode
- status
- narration
- vcNumber
GET /api/SubApp/transactions?vcNumber=012345678901&fromDate=2026-07-01&toDate=2026-09-29&page=1&pageSize=20 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "page": 1, "pageSize": 20, "total": 14, "transactions": [ { "txnId": "DTV-RCH-884291", "txnDate": "2026-09-12T18:41:02+05:30", "txnType": "RECHARGE", "amount": 399.00, "currency": "INR", "mode": "UPI", "status": "SUCCESS", "narration": "Instant recharge Super Family Hindi", "vcNumber": "012345678901" } ] }List invoices
GET
/api/SubApp/invoicesopenfinanceReturns billed periods, tax-inclusive totals and PDF links for the My Invoice screen.
Auth: Authorization: Bearer accessToken. vcNumber scopes the billing account.
- invoiceNumber
- invoiceDate
- periodFrom
- periodTo
- packName
- amount
- taxAmount
- totalAmount
- currency
- pdfUrl
- status
GET /api/SubApp/invoices?vcNumber=012345678901&page=1&pageSize=12 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "invoices": [ { "invoiceNumber": "INV-202609-4412", "invoiceDate": "2026-09-01", "periodFrom": "2026-08-13", "periodTo": "2026-09-12", "packName": "Super Family Hindi", "amount": 399.00, "taxAmount": 71.82, "totalAmount": 470.82, "currency": "INR", "pdfUrl": "/invoices/INV-202609-4412.pdf", "status": "PAID" } ] }Fetch EPG channel guide
GET
/api/SubApp/epg/guideopendataServes the electronic programme guide behind Channel Guide: per-LCN listings, synopsis, favourite flags and reminder state.
Auth: Authorization: Bearer accessToken. date and optional genre / language filter the grid; subscribedOnly=true limits rows to the current pack.
- date
- genre
- subscribedOnly
- channels
- channelId
- channelName
- lcn
- isFavorite
- programmes
- programmeId
- title
- startTime
- endTime
- synopsis
- reminderSet
GET /api/SubApp/epg/guide?vcNumber=012345678901&date=2026-09-29&genre=GEC&subscribedOnly=true HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "date": "2026-09-29", "channels": [ { "channelId": "CH-101", "channelName": "Star Plus", "lcn": 101, "isFavorite": true, "programmes": [ { "programmeId": "EPG-101-1840", "title": "Anupamaa", "startTime": "2026-09-29T18:30:00+05:30", "endTime": "2026-09-29T19:00:00+05:30", "synopsis": "Daily soap", "reminderSet": false } ] } ] }List offers and limited packs
GET
/api/SubApp/offersopendataReturns recharge and pack offers (flat/percent, min amount, validity, eligible packIds) shown on the home banners and Offer limited tile.
Auth: Authorization: Bearer accessToken. Optional vcNumber personalises offers to the current pack.
- offers
- offerId
- title
- description
- discountType
- discountValue
- minRechargeAmount
- validTill
- applicablePackIds
- bannerUrl
GET /api/SubApp/offers?vcNumber=012345678901 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "offers": [ { "offerId": "OFF-FESTIVE-50", "title": "Festive ₹50 off", "description": "₹50 off on recharge of ₹399 or more", "discountType": "FLAT", "discountValue": 50.00, "minRechargeAmount": 399.00, "validTill": "2026-10-31", "applicablePackIds": ["PK-SUPER-FAMILY-HINDI"], "bannerUrl": "/banners/festive-50.webp" } ] }Create issue-tracker ticket
POST
/api/SubApp/issuesopendataOpens a service ticket from Issue Tracker (no-signal, recharge not reflected, box errors) and returns ticketId, status and on-device troubleshoot steps.
Auth: Authorization: Bearer accessToken. Optional photo from the camera permission; ticket is bound to vcNumber.
- vcNumber
- category
- description
- stbOn
- errorCode
- ticketId
- ticketStatus
- createdAt
- etaHours
- troubleshootSteps
POST /api/SubApp/issues HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "vcNumber": "012345678901", "category": "NO_SIGNAL", "description": "No signal after recharge, error 101", "stbOn": true, "errorCode": "101" }{ "status": "SUCCESS", "ticketId": "SR-95017-88421", "vcNumber": "012345678901", "category": "NO_SIGNAL", "ticketStatus": "OPEN", "createdAt": "2026-09-29T18:12:04+05:30", "etaHours": 24, "troubleshootSteps": [ "Keep the set-top box powered on", "Reseat the LNB cable", "Wait for the next signal refresh" ] }
Data categories
- identity
- balances
- transactions
- billing
- catalog
- epg
Where teams use this data
DTH balance and switch-off monitoring
A household-billing bot calls GET /api/SubApp/account/summary per vcNumber after the RMN OTP session and alerts when balanceAmount or switchOffDate is inside a chosen window, using monthlyRechargeAmount as the suggested top-up.
Pack and channel-lineup reconciliation
A content-rights dashboard pulls GET /api/SubApp/packs/current (channelId, lcn, genre, quality, addOns) and diffs it against GET /api/SubApp/packs/catalog so operators can see which bouquets and a-la-carte rows a VC actually carries.
Recharge ledger into finance tools
Nightly jobs page GET /api/SubApp/transactions and GET /api/SubApp/invoices to land txnId, mode, payableAmount and GST taxAmount into an INR cashbook, matching Juspay orderId from POST /api/SubApp/recharge/initiate.
EPG-aware viewing reminders
A companion client reads GET /api/SubApp/epg/guide for subscribedOnly=true channels, then uses programmeId / startTime / isFavorite to schedule reminders that match the in-app Channel Guide.
Frequently asked questions
How does My DishTV authenticate a subscriber?
The app sends a 6-digit SMS OTP to the registered mobile number at POST /api/SubApp/auth/otp, then exchanges otpTxnId + otp at /api/SubApp/auth/verify for a Bearer accessToken and the list of VC numbers linked to that RMN. Later SubApp calls attach Authorization: Bearer; request bodies are JWT-signed by the native encryption plugin.
Which fields describe a DishTV connection's money state?
GET /api/SubApp/account/summary returns balanceAmount and currency (INR), monthlyRechargeAmount, switchOffDate, lastPaymentDate / lastPaymentAmount, and the currentPack object (packId, packName, endDate) for the selected vcNumber / stbId.
How does instant recharge work in the API?
POST /api/SubApp/recharge/initiate creates an order for a vcNumber and amount (optionally offerId, payLater, rechargeForFriend). The response includes orderId, payableAmount, juspayClientId / juspayOrderId and paymentUrl; Juspay HyperSDK (merchant dishtv) completes UPI, card, wallet or net-banking. The resulting row appears on GET /api/SubApp/transactions.
Can I read the channel lineup and EPG, not just the balance?
Yes. GET /api/SubApp/packs/current returns subscribed channels (channelId, lcn, genre, language, quality) and add-ons; GET /api/SubApp/packs/catalog pages recommended / combo / a-la-carte rows; GET /api/SubApp/epg/guide returns per-programme title, startTime, synopsis and reminderSet for the Channel Guide screen.
Apps similar to My DishTV
- Tata Play — The official self-care app of Tata Play (formerly Tata Sky), India's other large DTH satellite provider, where subscribers check balance, recharge and manage their pack and channels.
- Airtel Thanks — Airtel's all-in-one app that manages Airtel Digital TV alongside mobile and broadband, with DTH balance checks, recharges and add/remove-channel options on its Manage DTH page.
- Paytm — India's payments app whose DTH recharge section supports Dish TV, Tata Play and Airtel Digital TV accounts, with recharge reminders for upcoming due dates.
- My Sun Direct — The official app of Sun Direct, the DTH operator focused on South India, used to manage its set-top box connection, plans and recharges.
- PhonePe — A UPI payments app whose DTH recharge covers India's major operators including Dish TV, Tata Play, Sun Direct and d2h, with small cashback offers.
- Freecharge — A recharge app with dedicated DTH pages for topping up Tata Play, Dish TV, Videocon d2h and Airtel Digital TV accounts.
Topics
- My DishTV API
- Dish TV subscriber API
- DTH recharge API
- VC number balance
- DishTV pack catalog
- switch-off date
- DishTV invoices
- EPG channel guide
Need this app's data API integrated?
We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.
- NDA + SOW on every engagement
- Delivery in 3–7 days
- Payment only after acceptance
- Work scoped to authorized use