Operator Lookup API

Operator Lookup API will give you the real-time results for telecom operator and circle in India


To use this API, you need an API key.
Please login to your account and navigate to dashboard > API configuration

Learn how to authenticate the APIs.

Find Operator & Circle

Use the below endpoint to fetch operator and circle

/operator-lookup/get-operator-circle
curl -X GET https://ippocloud.com/api/v1
/operator-lookup/get-operator-circle?phone_number=734843XXXX
-H "Authorization: Basic bGl2ZV82MzAzZT...."
$url = "https://ippocloud.com/api/v1
/operator-lookup/get-operator-circle?phone_number=734843XXXX";
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$headers = array(
   "Authorization: Basic bGl2ZV82MzAzZT....",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
var url = "https://ippocloud.com/api/v1
/operator-lookup/get-operator-circle?phone_number=734843XXXX";
var xhr = new XMLHttpRequest();
xhr.open("GET", url);
xhr.setRequestHeader("Authorization", "Basic bGl2ZV82MzAzZT....");
xhr.onreadystatechange = function () {
   if (xhr.readyState === 4) {
      console.log(xhr.status);
      console.log(xhr.responseText);
   }};
xhr.send();
import requests
from requests.structures import CaseInsensitiveDict
url = "https://ippocloud.com/api/v1
/operator-lookup/get-operator-circle?phone_number=734843XXXX"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Basic bGl2ZV82MzAzZT...."
resp = requests.get(url, headers=headers)
print(resp.status_code)
URL url = new URL("https://ippocloud.com/api/v1
/operator-lookup/get-operator-circle?phone_number=734843XXXX");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Basic bGl2ZV82MzAzZT....");
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
var url = "https://ippocloud.com/api/v1
/operator-lookup/get-operator-circle?phone_number=734843XXXX";
var httpRequest = (HttpWebRequest)WebRequest.Create(url);
httpRequest.Headers["Authorization"] = "Basic bGl2ZV82MzAzZT....";
var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
   var result = streamReader.ReadToEnd();
}
Console.WriteLine(httpResponse.StatusCode);
{
    "data": {
        "entity": "operator_lookup",
        "operator": {
            "entity": "operator",
            "operator_name": "Jio",
            "operator_code": "RP",
            "logo": "https://ippocloud.com/assets/images/RP.png"
        },
        "circle": {
            "entity": "circle",
            "circle_name": "Karnataka",
            "circle_code": "KA"
        }
    }
}

Path parameters

phone_number

mandatory

string The number which you want to find its operator and circle

Response Parameters

data

object contains details of the operator and circle

entity

string something that exists separately from something else and has its own identity.

operator

object contains all the info of the operator such as operator name ect.

operator_name

string the name of the operator. JIO, AIRTEL, BSNL ECT

operator_code

string returns the unique code of the operator which you can use it later for recharge

logo

string returns the logo URL of the operator

circle

object contains all the info of the circle such as circle name ect.

circle_name

string the name of the circle. Karnataka, mumbai, gujarat ect

circle_code

string returns the unique code of the circle which you can use it later for fetch prepaid recharge plans

Do you need help to implement this API? contact us