Skip to main content
  1. Home
  2. Blog
  3. Recharge API
  4. Operator Detection API: Find the Operator and Circle Before You Recharge

Operator Detection API: Find the Operator and Circle Before You Recharge

Recharge screen detecting Airtel and Andhra Pradesh circle from a mobile number

Years ago, the first few digits of a mobile number told you the operator. With mobile number portability, that is no longer reliable. A customer may have moved from one network to another and kept the same number.

If your recharge screen guesses the operator from the series, some of those recharges go to the wrong operator. They fail, or worse, sit pending and confuse everyone.

What an operator detection API returns

You send the mobile number. The API returns the current operator and the telecom circle. A typical reply looks like this:

{
  "status": "Success",
  "mobile": "98XXXXXX21",
  "operator": "Airtel",
  "circle": "Andhra Pradesh"
}

How to use it on your recharge screen

  1. As soon as ten digits are entered, call the detection API
  2. Pre-select the operator and circle, but let the retailer change it
  3. Load the plan list for that operator and circle
  4. Send the recharge with the detected circle code

The retailer saves a tap, and the customer sees plans for their own circle instead of a generic list.

Where detection matters most

  • Ported numbers, which a series-based guess gets wrong
  • Customer apps, where people do not know or care what "circle" means
  • Bulk or API recharges, where nobody looks at each number

Things to check

  • Coverage of Airtel, Jio, Vi and BSNL across circles
  • Response time, because it runs while the retailer is typing
  • What happens when a number cannot be found: your screen should simply ask the retailer to pick
  • Whether it shares a login and quota with your plan API
Do not over-trust it: keep a manual operator dropdown. Detection is a strong default, not a lock. A customer standing at the counter knows their own SIM.

A quick example from the counter

A customer gives a number that starts with a series once used by one operator. The retailer selects that operator out of habit. The number was ported two years ago. The recharge fails, the customer waits, the retailer tries again with another operator, and the customer leaves unhappy.

With detection on the screen, the correct operator is already selected after the tenth digit. The retailer only confirms the plan. That is a few seconds saved per recharge and one fewer argument at the counter, many times a day.

Detection plus the right circle code

Our recharge API accepts a circle code with each request (send 0 if you do not know it). Sending the detected circle helps with circle-specific plans. The operator codes guide lists the codes and the most common error messages.

A1Topup's Operator Detection API comes with the same login as our Plan API and Bill Fetch API. Want to test it? WhatsApp us.

Frequently asked questions

Why can’t I find the operator from the first digits of a number?
Because of mobile number portability. A customer can move to another operator and keep the same number, so the series no longer shows the current operator.
What does an operator detection API return?
The current operator and telecom circle for a mobile number, so your app can pre-select them and load the right plans.
Should I still show an operator dropdown?
Yes. Use detection as the default, but let the retailer change it if the customer says otherwise.

Have a question? Talk to our team

We respect your privacy. Your details are only used to contact you about A1Topup.

Related articles

WhatsApp