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) is debited from your wallet on every successful response, on top of counting against your daily plan quota.

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"
Note: counts against your daily plan quota, but is not currently a paid (wallet-charged) hit.

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"

Electricity Bill Fetch

GET

Fetches the current due amount and bill details for an electricity connection. Verifies the customer's bill number and helps prevent fraud before payment.

Request

https://a1planapi.com/planapi/electricityBillFetch?username=[user]&pwd=[pwd]&operatorcode=[board code]&billnumber=[number]&optional1=[dob/district code]&optional2=[]&optional3=[]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
operatorcodestringRequiredElectricity board code — see Operator Code List.
billnumberstringRequiredCustomer's bill / consumer number.
optional1stringOptionalSome boards require a DOB or district code here — depends on the operator.
optional2stringOptionalExtra parameter, board-dependent.
optional3stringOptionalExtra parameter, board-dependent.

Response

Success Not enabled / low balance 
"ERROR": "0",
"STATUS": "1",
"BILLDEATILS": {
  "Name": "Dummy Name",
  "DueAmount": "0000.00",
  "DueDate": "2026-11-22",
  "BillNumber": null,
  "BillDate": "NA",
  "Balance": "0",
  "BillPeriod": null
},
"ORDERID": null,
"MESSAGE": "Bill Fetch Processed"
"ERROR": "1",
"STATUS": "0",
"Message": "Insufficient wallet balance."
Note: billed per hit directly from your wallet balance (paisa amount set per board) — this does not count against your monthly plan quota, and only a successful lookup is charged. Note the response's BILLDEATILS key is spelled that way by the upstream provider.

Postpaid Bill Fetch

GET

Fetches the current due amount for a postpaid mobile/landline connection.

Request

https://a1planapi.com/planapi/postpaidBillFetch?username=[user]&pwd=[pwd]&operatorcode=[PAT/IP/VP/JPP/BP/DP/LBS/LMT/LAT]&mobileno=[number]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
operatorcodestringRequiredPostpaid operator code — see Operator Code List.
mobilenostringRequiredPostpaid mobile number or consumer number.

Response

Success Not enabled / low balance 
"ERROR": "0",
"STATUS": "1",
"BILLDEATILS": {
  "Name": "NA",
  "DueAmount": "470.46",
  "DueDate": "2026-04-11",
  "BillNumber": "9XXXXXXXX9",
  "BillDate": "01 Apr 2026",
  "Balance": "",
  "BillPeriod": null
},
"ORDERID": null,
"MESSAGE": "Bill Fetch Processed"
"ERROR": "1",
"STATUS": "0",
"Message": "Insufficient wallet balance."
Note: billed per hit directly from your wallet balance — not part of your monthly plan quota. Only a successful lookup is charged.

FASTag Bill Fetch

GET

Fetches the current due amount / recharge info for a FASTag against a vehicle number.

Request

https://a1planapi.com/planapi/fastagBillFetch?username=[user]&pwd=[pwd]&operatorcode=[issuer code]&vehicleno=[number]
ParameterTypeRequiredDescription
usernamestringRequiredYour account username.
pwdstringRequiredYour account API password.
operatorcodestringRequiredFASTag issuer code — see Operator Code List.
vehiclenostringRequiredVehicle registration number the FASTag is linked to.

Response

Success Not enabled / low balance 
"ERROR": "0",
"STATUS": "1",
"BILLDEATILS": {
  "Name": "XXX XXX XXX",
  "DueAmount": "100.00",
  "DueDate": "2026-08-08",
  "BillNumber": "",
  "BillDate": "NA",
  "Balance": "115",
  "BillPeriod": null
},
"ORDERID": null,
"MESSAGE": "Bill Fetch Processed"
"ERROR": "1",
"STATUS": "0",
"Message": "Insufficient wallet balance."
Note: billed per hit directly from your wallet balance — not part of your monthly plan quota. Only a successful lookup is charged.

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. It does not reflect wallet balance — see your Wallet Statement page for that.

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, the DTH endpoints, and Bill Fetch. 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
Bangalore Electricity Supply Company (BESCOM)BESCOMElectricity
MSEDC - MaharashtraMSEDCElectricity
WBSEDCL - West BengalWBSEDCLElectricity
TNEB - Tamil NaduTNEBElectricity
…full electricity board list matches your Operator Code List page (70+ boards) — trimmed here for length.
ICICI Bank FASTagICFFASTag
HDFC Bank FASTagHDFFASTag
Axis Bank FASTagAXFFASTag
Paytm Payments Bank FASTagPTFFASTag
…full FASTag issuer list matches your Operator Code List page — trimmed here for length.

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