Operator and Circle Check

Telecom
POST /api/v1/operator-circle/check Bearer

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.

Availability

🗺 Country-specific

India

What Operator and Circle Check Is Used For

Recharge platforms

Detect the operator and circle from the number alone, so a customer never picks the wrong one and loses a recharge.

Number portability handling

Get the current operator after an MNP port, not the one the number series originally belonged to.

Routing and pricing

Route a transaction to the right operator API and apply the correct circle-specific plan set.

Telecom analytics

Profile a customer base by operator and circle for campaign targeting.

Quick Start

1. Copy your API key from Dashboard → API Keys
2. Send a POST request to /api/v1/operator-circle/check
3. Pass the key as Authorization: Bearer <key>
4. Read the result from the data object in the JSON response

cURL

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"}'
🚀 Send Request
✓ Key saved

🔑 Remember API Key

One-click convenience for testing & troubleshooting — no account needed.

1

What it doesSaves your API key in this browser only using localStorage. Next time you open a docs page, the Try It panel is pre-filled automatically.

2

Auto-updatesIf you type a different key into any Try It field, the saved key is replaced instantly — only the most recent key is ever stored.

3

Uncheck to forgetUnchecking “Remember API Key” immediately deletes the stored key and clears the field. While unchecked, nothing is saved even if you type a new key.

4

Re-check to save againChecking the box again saves whatever key is currently in the Try It field.

⚠ Security note: Your key is stored only in your browser and is never sent to any server except as part of the actual API call you send. Do not use this feature on shared or public computers.

More on this API

Request Endpoint, authentication headers, every request parameter with its type, and a sample request body. Response The full success response payload, field by field. Error Codes HTTP status codes, error payload shape, and how to handle failures. Code Examples Ready-to-run examples in cURL, PHP, JavaScript and Python. Rate Limits Per-minute and per-day request limits, and what happens on breach. AI Agent / LLM The whole endpoint as one Markdown brief — paste into Claude, Cursor, Copilot or ChatGPT.