Operator & Circle Fetch

GET

Resolves a mobile number to its current operator and telecom circle. Call this before Plan Fetch, since Plan Fetch needs the operator code and circle it returns.

Request

NameOperator & Circle Fetch
TypeGET
https://a1planapi.com/planapi/operatorCircleFetch?username=[user]&pwd=[pwd]&mobileno=[10-digit number]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username, issued at signup.
pwdstringRequiredYour account API password.
mobilenostringRequired10-digit subscriber number to look up.

Response

Success Auth failed 
"ERROR": "0",
"STATUS": "1",
"Mobile": "8125943396",
"Operator": "AIRTEL",
"OpCode": "A",
"Circle": "Andhra Pradesh",
"CircleCode": "49",
"Message": "Successfully"
"ERROR": "1",
"STATUS": "0",
"Message": "Authentication fail"
Next step: use the OpCode and CircleCode from this response as the operatorcode and circle parameters on the Plan Fetch endpoint.

Plan Fetch

GET

Returns live prepaid recharge plans for an operator and circle — grouped into categories such as recommended packs, data packs, unlimited packs, top-ups and roaming.

Request

NamePlan Fetch
TypeGET
https://a1planapi.com/planapi/planFetch?username=[user]&pwd=[pwd]&operatorcode=[A/RC/V/I/BT/BR]&circle=[code]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
operatorcodestringRequiredOne of A / RC / V / I / BT / BR (Airtel / Jio / Vodafone-Vi / Idea / BSNL).
circlestringRequiredCircle code from Operator & Circle Fetch (e.g. 49 for Andhra Pradesh).

Response

Success Auth failed 
"ERROR": "0",
"STATUS": "0",
"Operator": "Airtel",
"Circle": "AP",
"RDATA": {
  "Recommended Packs": [
    { "rs": 49, "validity": "1 day", "desc": "DATA : Unlimited | COMBO : 1 day" }
  ],
  "Top DATA Packs": [ "…" ],
  "Truly Unlimited": [ "…" ]
},
"MESSAGE": "Operator Plan Successfully"
"ERROR": "1",
"STATUS": "0",
"Message": "Insufficient balance"
Note: this is a paid hit — a flat paisa amount (set per operator, per your scheme) is debited from your wallet on every successful response.

R-Offer Check

GET

Checks subscriber-specific special offers (roffers) for a mobile number against live HLR data.

Request

https://a1planapi.com/planapi/rofferCheck?username=[user]&pwd=[pwd]&operatorcode=[A/RC/V/I/BT]&mobileno=[number]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
operatorcodestringRequiredOne of A / RC / V / I / BT / BR.
mobilenostringRequired10-digit subscriber number.

Response

"ERROR": "0",
"STATUS": "1",
"MOBILENO": "1234567890",
"RDATA": [
  { "price": "29", "ofrtext": "Stay connected with 2GB data…" }
],
"MESSAGE": "Offer Successfully Checked"

DTH Basic Info

GET

Basic DTH subscriber details for a viewer card / mobile number — name, VC number, RMN.

Request

https://a1planapi.com/planapi/dthBasicInfo?username=[user]&pwd=[pwd]&mobileno=[VC/number]&operatorcode=[ATV/TTV/VTV/STV/DTV]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
mobilenostringRequiredDTH VC number.
operatorcodestringRequiredOne of ATV / TTV / VTV / STV / DTV.

Response

"error": "0",
"DATA": {
  "VC": "1231212112",
  "Name": "Dummy",
  "Rmn": "121212121",
  "Address": "…"
},
"Message": "Details Fetch Successfully!!!"

DTH Info Check

GET

Fuller DTH subscriber details, including current balance and address.

Request

https://a1planapi.com/planapi/dthInfoCheck?username=[user]&pwd=[pwd]&mobileno=[VC/number]&operatorcode=[ATV/TTV/VTV/STV/DTV]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
mobilenostringRequiredDTH VC number.
operatorcodestringRequiredOne of ATV / TTV / VTV / STV / DTV.

Response

"error": "0",
"DATA": {
  "VC": "3012763522",
  "Name": "MR Milind .",
  "Balance": "310.28",
  "PIN Code": "422009"
},
"Message": "Offer Successfully Checked"

DTH Info + Last Recharge Date

GET

Same as DTH Info Check, with the subscriber's last recharge date included.

Request

https://a1planapi.com/planapi/dthInfoWithLastRecharge?username=[user]&pwd=[pwd]&mobileno=[VC/number]&operatorcode=[ATV/TTV/VTV/STV/DTV]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
mobilenostringRequiredDTH VC number.
operatorcodestringRequiredOne of ATV / TTV / VTV / STV / DTV.

Response

"error": "0",
"DATA": {
  "VC": "301211222",
  "Name": "MR Milind .",
  "Balance": "310.28"
},
"Message": "Offer Successfully Checked"

DTH Plan Fetch

GET

Channel packs and pricing for a DTH operator.

Request

https://a1planapi.com/planapi/dthPlanFetch?username=[user]&pwd=[pwd]&operatorcode=[ATV/TTV/VTV/STV/DTV]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
operatorcodestringRequiredOne of ATV / TTV / VTV / STV / DTV.

Response

"ERROR": "0",
"Operator": "AIRTEL DTH",
"RDATA": {
  "Combo": [
    { "Language": "Hindi", "PackCount": "1" }
  ]
}

DTH Operator Check

GET

Resolves a DTH number to its provider.

Request

https://a1planapi.com/planapi/dthOperatorCheck?username=[user]&pwd=[pwd]&dthnumber=[number]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
dthnumberstringRequiredDTH subscriber number.

Response

"ERROR": "0",
"STATUS": "1",
"DthNumber": "705XXXXX61",
"DthName": "SUN DIRECT",
"DthOpCode": "STV",
"Message": "Successfully"

Usage & Subscription Status

GET

Check your active plan, how many days are left on your subscription, and how many hits you've used today. This call does not count against your daily quota — check it as often as you like.

Request

NameUsage & Subscription Status
TypeGET
https://a1planapi.com/planapi/usageStatus?username=[user]&pwd=[pwd]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.

Response

Success No subscription 
"ERROR": "0",
"STATUS": "1",
"PlanName": "GOLD",
"BillingCycle": "monthly",
"StartDate": "2026-08-01",
"EndDate": "2026-09-01",
"DaysLeft": 7,
"DailyHitLimit": 10000,
"HitsUsedToday": 342,
"HitsLeftToday": 9658,
"Message": "Successfully"
"ERROR": "1",
"STATUS": "0",
"Message": "No active subscription. Please subscribe to a plan."
Tip: poll this once when your app starts, or show it on a dashboard — no need to call it before every request.

Operator Code List

These are our own operator codes — pass these into operatorcode on Plan Fetch, R-Offer Check, and the DTH endpoints. Every response you get back from us (including Operator & Circle Fetch) also uses these same codes, never a third-party's internal numbers.

Operator NameOperator CodeService Type
AirtelAMobile
Reliance JioRCMobile
Vodafone / ViVMobile
IdeaIMobile
BSNL-TOPUPBTMobile
BSNL-STVBRMobile
Airtel Digital DTHATVDTH
Tata SkyTTVDTH
Videocon D2HVTVDTH
Sun DirectSTVDTH
Dish TVDTVDTH
Airtel PostpaidPATPostpaid
Idea PostpaidIPPostpaid
Vodafone PostpaidVPPostpaid
JIO PostpaidJPPPostpaid
BSNL PostpaidBPPostpaid
Tata Docomo PostpaidDPPostpaid
BSNL LandlineLBSPostpaid
MTNL Delhi LandlineLMTPostpaid
Airtel LandlineLATPostpaid
North Bihar ElectricityNBEElectricity
JBVNL - JharkhandJBVNLElectricity
Assam Power Distribution Company Ltd (RAPDR)APDCLRElectricity
Mangalore Electricity Supply Co. Ltd (MESCOM) - RAPDRMESCOMRElectricity
APDCL (Non-RAPDR) - AssamAPDCLNElectricity
Mangalore Electricity Supply Co. Ltd (Non-RAPDR)MESCOMNRElectricity
BSES Rajdhani Power Limited - DelhiBSESElectricity
BSES Yamuna Power Limited - DelhiBSESYElectricity
Tata Power Delhi Limited - DelhiTPDElectricity
Tata Power - MumbaiTPDMElectricity
Hubli Electricity Supply Company Ltd. (HESCOM)HESCOMElectricity
South Bihar ElectricitySBEElectricity
BEST MumbaiBESTElectricity
Ajmer Vidyut Vitran Nigam - RajasthanAJVElectricity
Bangalore Electricity Supply Company (BESCOM)BESCOMElectricity
CESC - West BengalCESCElectricity
Jaipur Vidyut Vitran Nigam - RajasthanJVVElectricity
Jodhpur Vidyut Vitran Nigam - RajasthanJDVVElectricity
MP Madhya Kshetra Vidyut Vitaran - UrbanMKVElectricity
MSEDC - MaharashtraMSEDCElectricity
Noida Power - NoidaNPElectricity
Paschim Kshetra Vitaran - Madhya PradeshPKVElectricity
Southern Power - Andhra PradeshSPAElectricity
Southern Power - TelanganaSPTElectricity
Torrent Power AgraTRPElectricity
Central Power Distribution Company of Andhra Pradesh LtdAPCPDCLElectricity
Department of Power Arunachal PradeshARPDOPElectricity
Western Electricity Supply Co. of Orissa Ltd.WESCOElectricity
Paschim Gujarat Vij Company LtdPGVCLElectricity
Bharatpur Electricity Services LtdBHESElectricity
Muzaffarpur Vidyut VitranMVVElectricity
Madhya Gujarat Vij Company LtdMGVCLElectricity
Meghalaya Power Distribution (MEPDCL)MEPDCLElectricity
KEDL - KotaKEDLElectricity
Dakshin Gujarat Vij Company LtdDGVCLElectricity
WBSEDCL - West BengalWBSEDCLElectricity
SNDL Power - NagpurSNDLElectricity
Bikaner Electricity Supply LimitedBESLElectricity
India Power - West BengalIPWBElectricity
Brihanmumbai Electric Supply & Transport (BEST)BMESTUElectricity
APEPDCL - Andhra PradeshAPEPDCLElectricity
TNEB - Tamil NaduTNEBElectricity
UPPCL (Urban) - Uttar PradeshUPPCLUElectricity
UPPCL (Rural) - Uttar PradeshUPPCLRElectricity
Dakshin Haryana Bijli Vitran NigamDHBVNElectricity
TSNPDCL - Telangana Northern PowerTSNPDCLElectricity
Dadra & Nagar Haveli Power Distribution (DDCL)DDCLElectricity
Gulbarga Electricity Supply Company Ltd (GESCL)GESCLElectricity
India Power Corporation LimitedIPCLElectricity
Jamshedpur Utilities and Services CompanyJUSCLElectricity
Chhattisgarh State Power Distribution Company LtdCSPDCLElectricity
Goa ElectricityGOAELCElectricity
Uttar Gujarat Vij Company LtdUGVCLElectricity
Torrent Power SuratTORRENTSURElectricity
Torrent Power AhmedabadTORRENTAHMElectricity
Gift Power Company LimitedGPCLElectricity
Himachal Pradesh State Electricity Board LtdHPSEBLElectricity
Jammu & Kashmir Power Development DepartmentJKPDDElectricity
Chamundeshwari Electricity Supply Corporation (CESC Mysore)CESCOMElectricity
North Delhi Power LimitedNDPLElectricity
Municipal Corporation of GurugramMCGElectricity
Punjab State Power Corporation LimitedPSPCLElectricity
Tripura State Electricity Corporation LtdTSECLElectricity
Uttar Haryana Bijli Vitran NigamUHBVElectricity
Uttarakhand Power Corporation LimitedUKPCLElectricity
Kerala State Electricity Board LtdKSEBElectricity
Kannan Devan Hills PowerKDHPCPLElectricity
Lakshadweep Electricity DepartmentLEDElectricity
MP Poorv Kshetra Vidyut Vitaran - JabalpurMPPKVVCLPUElectricity
MP Poorv Kshetra Vidyut Vitaran - RuralMPPKVVCLMRElectricity
MP Poorv Kshetra Vidyut Vitaran - UrbanMPPKVVCLElectricity
Reliance EnergyRELIANCEElectricity
Torrent Power ShilTORRENTSHIElectricity
Torrent Power BhivandiTORRENTBHIElectricity
Adani PowerAEMLElectricity
Manipur State Power Distribution Company Ltd (Prepaid)MSPDCLPRElectricity
Power & Electricity Department - MizoramMPEDElectricity
Department of Power - NagalandNDOPElectricity
New Delhi Municipal Council (NDMC) - ElectricityNDMCElectricity
NESCO OdishaNESCOElectricity
SOUTHCO OdishaSOUTHCOElectricity
TP Central Odisha Distribution LtdTPCODLElectricity
Puducherry Electricity DepartmentPGPEDElectricity
TP Ajmer Distribution LtdTPADLElectricity
Sikkim Power RuralSPRElectricity
Sikkim Power UrbanSPUElectricity
Kanpur Electricity Supply Company (KESCO)KESCOElectricity
Torrent Power DahejTORRENTDAHElectricity
Mahanagar GasMGGas
Adani GasAGGas
Gujarat GasGGGas
Indraprastha GasIGGas
HPCL GasHPCLGCGas
ICICI Prudential InsuranceICPInsurance
Tata AIA InsuranceTAIInsurance
Jammu & Kashmir Bank FASTagJKFFASTag
Kotak Mahindra Bank FASTagKMFFASTag
IndusInd Bank FASTagINDFFASTag
Indian Highways Management Company Ltd FASTagIHMCFFASTag
IDFC First Bank FASTagIFFFASTag
ICICI Bank FASTagICFFASTag
HDFC Bank FASTagHDFFASTag
Equitas Bank FASTagEFFFASTag
Bank of Baroda FASTagBBFFASTag
Axis Bank FASTagAXFFASTag
Federal Bank FASTagFDFFASTag
Paytm Payments Bank FASTagPTFFASTag
Airtel Payments Bank FASTagAPBFASTag
IDBI Bank FASTagIBFFASTag
SBI Bank FASTagSBFFASTag

Circle Code List

Telecom circle names and their codes — pass the code into Plan Fetch and R-Offer Check as the circle parameter. This list rarely changes, so it's shown here directly rather than as a live call.

IDCircle NameCircle Code
1DELHI10
2UP (West)97
3PUNJAB02
4HP03
5HARYANA96
6J&K55
7UP (East)54
8MUMBAI92
9MAHARASHTRA90
10GUJARAT98
11MP93
12RAJASTHAN70
13KOLKATTA31
14West Bengal51
15ORISSA53
16ASSAM56
17NESA16
18BIHAR52
19KARNATAKA06
20CHENNAI40
21TAMIL NADU94
22KERALA95
23AP49
24SIKKIM99
25TRIPURA100
26CHHATISGARH101
27GOA102
28MEGHALAY103
29MIZORAM104
30JHARKHAND105
31Manipur106