Home
About
Join Today
Join Today
  • Sign Up
  • Sign In
Conatct Us
Home
About
Join Today
Join Today
  • Sign Up
  • Sign In
Conatct Us
  1. Recharge
  • Introduction
  • Getting Started
  • Authentication
  • HTTPS Status Codes
  • Rate Limits
  • Callbacks
    • Recharge Callback
  • NSDL Account Opening
    • BC Agent Onboarding
      POST
    • Create Account
      POST
    • Account Status
      GET
  • Recharge
    • Operator List
      GET
    • HLR Check
      POST
    • DTH Info
      POST
    • Browse Plans
      POST
    • Initiate Recharge
      POST
    • Check Status
      GET
  • Bill Payment
    • Biller List
      POST
    • Fetch Bill
      POST
    • Bill Pay
      POST
  • Verification Suite
    • Digilocker
      • Initiate
      • Check Status
      • Download Aadhaar
    • Aadhaar
      • Send OTP
      • Verify OTP
    • UPI Verification
      POST
    • Bank Verification
      POST
    • PAN Verification
      POST
    • GSTIN Verification
      POST
  • Comunications API
    • Send SMS OTP
    • Send Whatsapp OTP
  1. Recharge

Browse Plans

POST
/api/v1/recharge/browse-plan
Fetch available recharge plans based on operator and telecom circle in real time. The API provides categorized recharge options including data plans, unlimited plans, validity packs, and special offers directly sourced from operators. Merchants can display updated plans inside applications without maintaining manual plan databases, ensuring users always view the latest recharge offerings.

🌍 Supported Circles & Operators#

Recharge requests must include a valid Circle (Operator Region).
Each telecom circle represents a service region used by operators for routing recharge transactions correctly.
CircleOperator
Andhra Pradesh TelanganaAndhra Pradesh Telangana
AssamAssam
Bihar JharkhandBihar Jharkhand
ChennaiChennai
Delhi NCRDelhi NCR
GujaratGujarat
HaryanaHaryana
Himachal PradeshHimachal Pradesh
Jammu KashmirJammu Kashmir
KarnatakaKarnataka
KeralaKerala
KolkataKolkata
Madhya Pradesh ChhattisgarhMadhya Pradesh Chhattisgarh
Maharashtra GoaMaharashtra Goa
MumbaiMumbai
North EastNorth East
OrissaOrissa
PunjabPunjab
RajasthanRajasthan
Tamil NaduTamil Nadu
UP EastUP East
UP WestUP West
West BengalWest Bengal

⚠️ Important Guidelines#

WARNING
Please copy the Circle / Operator name exactly with spaces as listed above.
Circle values are case-sensitive and must match API requirements.
Incorrect circle selection may lead to recharge failure.
It is recommended to fetch circle values dynamically using the Operator List API.
Ensure circle matches HLR Check response for better transaction success rate.

Request

Header Params

Body Params application/json

Example
{
    "circle": "Delhi NCR",
    "operator_code": "11"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/recharge/browse-plan' \
--header 'x-client-id: {{client_id}}' \
--header 'x-client-secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "circle": "Delhi NCR",
    "operator_code": "11"
}'

Responses

🟢200Success
application/json
Body

Example
{
    "response_code": 200,
    "status": "success",
    "message": "Browse plans fetched successfully",
    "data": {
        "operator": "Airtel",
        "circle": "Bihar Jharkhand",
        "plans": {
            "TOPUP": [
                {
                    "rs": "10",
                    "desc": "Talktime : Rs 7.47",
                    "validity": "N/A",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "120",
                    "desc": "Talktime : Rs 98.69",
                    "validity": "N/A",
                    "last_update": "21-02-2026"
                }
            ],
            "3G/4G": [
                {
                    "rs": "22",
                    "desc": "Data : 1GB | Details: 1GB data valid for the same day till midnight, Revised price for Rs 19 pack",
                    "validity": "1 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "99",
                    "desc": "Data: Unlimited",
                    "validity": "2 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "279",
                    "desc": "Data : 1GB | Details :  Netflix, JioHotstar, Airtel Xstream Play & Zee5 for 1 month.",
                    "validity": "30 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "361",
                    "desc": "Data: 50GB | Validity: 30 days | Details: JioHotstar Subscription for 3 Months. Better choice over Rs. 161 & Rs. 195 pack",
                    "validity": "30 days",
                    "last_update": "21-02-2026"
                }
            ],
            "RATE CUTTER": [
                {
                    "rs": "18",
                    "desc": "Details: Enjoy ISD calling at discounted rates for 28 days. For country wise tariff visit www.airtel.in | Validity : 28 days",
                    "validity": "28 days",
                    "last_update": "21-02-2026"
                }
            ],
            "Romaing": [
                {
                    "rs": "295",
                    "desc": "Details : In-Flight - 500 MB, 100mins OG, No incoming calls, 100 SMS (selected Intl flights) | For covered flights, visit www.airtel.in/IR",
                    "validity": "1 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "595",
                    "desc": "Details : In-Flight - 1 GB, 100mins OG, No incoming calls, 100 SMS (selected Intl flights) | For covered flights, visit www.airtel.in/IR",
                    "validity": "1 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "698",
                    "desc": "Details : 1GB, 100mins IC+OG (IN+Local), 10 SMS (USA, Europe, Gulf, Asia, Africa & more) | Revised price for Rs. 648 pack | Know more, www.airtel.in/IR ",
                    "validity": "1 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "2998",
                    "desc": "Details : 10GB, 300mins IC+OG (IN+Local), 20 SMS (USA, Europe, Gulf, Asia, Africa & more) | Know more, www.airtel.in/IR ",
                    "validity": "30 days",
                    "last_update": "21-02-2026"
                }
            ],
            "COMBO": [
                {
                    "rs": "199",
                    "desc": "Calls : Unlimited local, STD & Roaming | Data : 2GB | SMS : 100 SMS/day | Details: Revised price for 155 & 179 pack",
                    "validity": "28 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "219",
                    "desc": "Calls : Unlimited local STD & Roaming | Data : 3GB | SMS : 300 | Details : 1GB extra data vs 199",
                    "validity": "28 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "279",
                    "desc": "Data : 1GB | Details :  Netflix, JioHotstar, Airtel Xstream Play & Zee5 for 1 month.",
                    "validity": "30 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "299",
                    "desc": "Calls : Unlimited local, STD & Roaming | Data : 1GB/Day | SMS : 100 SMS/Day | Details: Best upgrade pack for Rs. 199 , Rs. 219 & Rs. 469  packs",
                    "validity": "28 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "319",
                    "desc": "Calls : Unlimited local, STD & Roaming | Data : 1.5 GB/day | SMS : 100/day | Details : Google One Cloud Storage of 30GB  for 1 month. Free Apple Music for up to 6 months.",
                    "validity": "30 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "349",
                    "desc": "Calls : Unlimited local, STD & Roaming | Data : Unlimited 5G + 1.5 GB/day | SMS : 100/day | Details : UNLIMITED 5G data (over & above plan limit). Airtel Xstream Play Premium for 28 days. Free Apple Music for up to 6 months. | Details: Best upgrade pack for Rs.199 , Rs. 219 , Rs. 249 , Rs. 299 , Rs. 319 , Rs. 579 , Rs. 619 & Rs. 799 packs",
                    "validity": "28 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "799",
                    "desc": "Calls : Unlimited Local STD & Roaming | Data : 1.5GB/Day | SMS : 100 SMS/Day",
                    "validity": "77 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "838",
                    "desc": "Calls : Unlimited local STD & Roaming | Data : Unlimited 5G + 3GB/day | SMS : 100/Day | Details : 56 days Amazon Prime Lite subscription, Airtel Xstream Play subscription for 56 days, UNLIMITED 5G data (over & above plan limit)",
                    "validity": "56 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "859",
                    "desc": "Calls : Unlimited Local STD & Roaming calls | Data : 1.5GB/day | SMS : 100 per day | Details : Airtel Mini Rewards123 for 3 months, Rs. 859 pack is a better choice over Rs. 799",
                    "validity": "84 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "929",
                    "desc": "Calls : Unlimited local STD & Roaming | Data : 1.5GB/Day | SMS : 100/Day",
                    "validity": "90 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "979",
                    "desc": "Calls : Unlimited local STD & Roaming | Data : Unlimited 5G + 2GB/day | SMS : 100/Day | Details : Airtel Xstream Play subscription for 84 days & Cashback of upto Rs 80/month for 3 months with Airtel Mini Rewards123, UNLIMITED 5G data (over & above plan limit), Revised price for Rs 839 pack, Best Upgrade Pack for Rs. 548 , Rs. 799 , Rs. 859 & Rs. 929 packs",
                    "validity": "84 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "1029",
                    "desc": "Calls : Unlimited local STD & Roaming | Data : Unlimited 5G + 2GB/day | SMS : 100/Day | Details : JioHotstar Mobile subscription for 3 months & Cashback of upto Rs 80/month for 3 months with Airtel Mini Rewards123, UNLIMITED 5G data (over & above plan limit), Best Upgrade Pack for Rs. 929 & Rs. 979 packs",
                    "validity": "84 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "1199",
                    "desc": "Calls : Unlimited Local STD & Roaming calls | Data : Unlimited 5G + 2.5GB/day | SMS : 100 per day | Details : Amazon Prime Lite 84 days, Airtel Xstream play for 84 days, Airtel Mini Rewards123 90 days, UNLIMITED 5G data (over & above plan limit)",
                    "validity": "84 days",
                    "last_update": "21-02-2026"
                },
                {
                    "rs": "1729",
                    "desc": "Calls : Unlimited local, STD & Roaming | Data : Unlimited 5G + 2GB/day | SMS : 100 SMS/day | Details : JioHotstar subscription for 3 months, Netflix Basic, Zee5 & Airtel Xstream Play for 84 days, UNLIMITED 5G data (over & above plan limit)",
                    "validity": "84 days",
                    "last_update": "21-02-2026"
                }
            ]
        }
    },
    "meta": {
        "request_id": "bceaae6d-2ddf-4906-a80d-57c8ba0fb3f6",
        "time": "2026-02-23T15:07:10+05:30"
    }
}
🟠422Validation Error
🟠401Unauthorized
Previous
DTH Info
Next
Initiate Recharge
Built with