Way2API® API documentation Sign in to grab your API key — or create a free account. Sign In Get Started

Indian Prepaid Recharge Plans Operators and Circles

Telecom
POST /api/v1/mobile/recharge-plans Bearer

Every value the operator and circle parameters accept. Matching ignores case, spaces and punctuation, so Airtel, Tamil Nadu, UP (East) and J&K all work as written. Anything else is rejected with INVALID_INPUT before the call is charged. If the customer does not know their operator or circle, look both up from the mobile number with the Operator and Circle Check API first.

Operators

Value to sendOperatorAlso accepted
airtelAirtelbharti_airtel
jioJioreliance_jio
viVi (Vodafone Idea)vodafone, idea, vodafone_idea
bsnlBSNLbsnl_topup, bsnl_special

MTNL and other operators are not covered.

Circles

Plans are sold per telecom circle, not per state. A state that shares a circle is accepted by name and answered with that circle's plans, and the circle field in the response always carries the circle it resolved to: send goa and it comes back as maharashtra.

Value to sendCircleAlso accepted
andhra_pradeshAndhra Pradesh and Telanganatelangana, ap
assamAssam
biharBihar and Jharkhandjharkhand, bihar_jharkhand
chennaiChennai
delhiDelhi NCRdelhi_ncr
gujaratGujarat
haryanaHaryana
himachal_pradeshHimachal Pradeshhp
jammu_kashmirJammu and Kashmirjammu_and_kashmir, j_k
karnatakaKarnataka
keralaKerala
kolkataKolkata
madhya_pradeshMadhya Pradesh and Chhattisgarhchhattisgarh, mp
maharashtraMaharashtra and Goagoa, maharashtra_goa
mumbaiMumbai
north_eastNorth Eastarunachal_pradesh, manipur, meghalaya, mizoram, nagaland, tripura, nesa
odishaOdishaorissa
punjabPunjab
rajasthanRajasthan
tamil_naduTamil Nadutamilnadu
up_eastUttar Pradesh (East)uttar_pradesh_east
up_westUttar Pradesh (West) and Uttarakhanduttarakhand, uttar_pradesh_west
west_bengalWest Bengal and Sikkimsikkim