General API

Operator and Circle Check

Instantly identify the telecom operator (Jio, Airtel, Vi, BSNL, etc.) and service circle/zone for any 10-digit Indian mobile number.

Operator and Circle Check
POST

Operator Circle Lookup API — Instantly identify the telecom operator (Jio, Airtel, Vi, BSNL, etc.) and service circle/zone for any 10-digit Indian mobile number. Essential for mobile recharge platforms, DTH services, telecom analytics, and number portability checks. Returns the operator name, circle (e.g., Karnataka, Maharashtra), and connection type (Prepaid or Postpaid). Handles MNP (Mobile Number Portability) — results reflect the current operator, not the original.

  • Coverage: India
  • Real-time general lookup
  • Structured JSON response
  • POST request with Bearer auth
Get API Key — Free View Full Docs
Endpoint
POST
https://app.way2api.com/api/v1/operator-circle/check

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
mobile_number string Yes 10-digit Indian mobile number — format: [6-9][0-9]{9} (e.g. 9876543210)
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/operator-circle/check", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "mobile_number" => "9876543210" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/operator-circle/check", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "mobile_number": "9876543210" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
curl -X POST https://app.way2api.com/api/v1/operator-circle/check \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{\"mobile_number\":\"9876543210\"}'
$.ajax({ url: "https://app.way2api.com/api/v1/operator-circle/check", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "mobile_number": "9876543210" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });
const { data } = await axios.post( "https://app.way2api.com/api/v1/operator-circle/check", {"mobile_number":"9876543210"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/operator-circle/check", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "mobile_number": "9876543210" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "mobile_number": "9876543210",
            "operator": "Jio",
            "circle": "Karnataka",
            "type": "Prepaid"
        }
    }
}
4xx Error Response 
""
Common Response Codes
Code Meaning
200 OK — Request successful
400 Bad Request — Missing or invalid parameters
401 Unauthorized — Invalid or missing API key
429 Too Many Requests — Rate limit exceeded
500 Server Error — Try again later
Ready to integrate?

Start with free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login