Operator Detection API
Type a number, get the operator and circle. Our Operator Detection API resolves any Indian mobile number to the operator it is on today and its telecom circle, so the right plans and the right recharge route are picked automatically.
- ISO 9001:2015 certified
- IP whitelist & e-KYC
- 24/7 WhatsApp support
What the Operator Detection API gives you
Most failed recharges start with the wrong operator. Detect it before you send the recharge, not after it fails.
GET /planapi/operatorCircleFetchOperator & circle fetch
Send a 10-digit number, get the operator, operator code, circle and circle code back, ready for plan fetch.
GET /planapi/dthOperatorCheckDTH operator check
Find the DTH provider of a subscriber number before fetching DTH plans or details.
GET /planapi/operatorListOperator code list (free)
Every operator code we accept, as JSON, to map against your own codes.
GET /planapi/circleListCircle code list (free)
All 31 telecom circles and their codes.
Full parameters and sample responses are in the API documentation. Operator and circle code lists are free calls.
Why platforms detect the operator first
Fewer failed recharges
Ported numbers are sent to the right operator, so recharges stop failing for "wrong operator".
Faster checkout
The retailer types the number and the operator and circle fill in by themselves.
Right plans every time
Use the circle from the lookup to fetch the exact plans for that number.
Operators and billers covered
Mobile, DTH and bills on one login, with the same JSON shape for every operator.
Prepaid mobile
- Airtel
- Jio
- Vi (Vodafone Idea)
- BSNL
All 31 telecom circles
DTH
- Airtel Digital TV
- Tata Play
- Dish TV
- Sun Direct
- Videocon d2h
Bill fetch
- 71+ electricity boards
- Postpaid mobile & landline
- 15 FASTag issuers
From sign-up to your first response
Three steps, usually done the same day.
- 1
Create your account
Sign up with your mobile number, complete e-KYC and pick the plan that fits your daily volume.
- 2
Whitelist your server
Add your server IP in the dashboard (up to 10), then call any endpoint with your username and password.
- 3
Go live and monitor
Track hits, wallet charges and success rate in your usage report, and upgrade any time.
Plans and pricing
Every plan includes every mobile, DTH and bill-fetch endpoint. The only difference is the number of hits per day.
Starter
Billed monthly
₹417 a month Save 17%
- Plan hits per day5,500
- All mobile, DTH and bill-fetch endpoints✓
- Usage status and code-list APIsFree
- Email support✓
Gold
Billed monthly
₹625 a month Save 22%
- Plan hits per day10,000
- All mobile, DTH and bill-fetch endpoints✓
- Usage status and code-list APIsFree
- Priority WhatsApp support✓
Platinum
Billed monthly
₹1,000 a month Save 33%
- Plan hits per day20,000
- All mobile, DTH and bill-fetch endpoints✓
- Usage status and code-list APIsFree
- Priority WhatsApp support✓
- Dedicated onboarding call✓
Prices in INR. Yearly billing locks your rate for 12 months. Plan fetch also debits a small per-operator amount from your wallet on each successful response. Bill fetches are charged per successful fetch from your wallet and do not use your daily hits; failed lookups cost nothing. Compare plans in detail
Built so you do not have to babysit it
One JSON shape
Jio or Sun Direct, mobile or DTH, the response structure stays the same, so you write less edge-case code.
Secure by default
IP whitelisting for up to 10 servers, mandatory e-KYC and a complete hit log protect your key and wallet.
Transparent quotas
No hidden throttling. See hits used and days left on the dashboard or through a free status call.
Fast repeat lookups
Popular operator and circle requests are served from a short cache, so they come back quickly.
Fair bill-fetch billing
Pay only for successful bill fetches. Failed lookups cost nothing and never touch your daily plan.
People on support
Email and WhatsApp reach the team that runs the API, with priority support on higher plans.
Questions about the Operator Detection API
What does the Operator Detection API return?
The current operator and telecom circle of an Indian mobile number, so your app can pick the right plans and recharge route.
Does it work for ported numbers?
It returns the operator the number is on now, so a number that moved from one operator to another is shown with its current operator. That is what prevents wrong-operator failures.
Can it detect DTH operators?
Yes. The DTH operator check finds the provider of a DTH subscriber number: Airtel Digital TV, Tata Play, Dish TV, Sun Direct or Videocon d2h.
How does the daily limit work?
Each plan includes a fixed number of hits per day across the mobile and DTH lookup endpoints. The counter resets at midnight India time, and you can check it any time with the free usage status endpoint.
What happens if I reach my daily limit?
Further calls return a clear daily limit message until the counter resets. You can upgrade to a higher plan at any time.
Is my API key protected?
Yes. You can whitelist up to 10 server IP addresses, e-KYC is required before you use the API, and every call is logged in your usage report.
Monthly or yearly: which should I pick?
Yearly billing is cheaper per month, saving up to 33%, and locks your rate for 12 months. Start monthly if you are still testing your volume.
Next step after detection: the recharge plan API. Free demo: our mobile plan finder.
Try it with a real number
Check the operator, circle and latest plans of any mobile or DTH number, powered by the same API.
Ready to Integrate Operator Detection?
Pick a plan or ask us about your daily volume. We reply on WhatsApp.
Rated 4.9/5 from 314 Google reviews by businesses.
- GST registeredGSTIN 36AAWCA0064F1ZN
- Since 2016In the recharge business
- 10,000+ partnersAcross India
- ISO 9001:2015Certified quality system
