Indian Prepaid Recharge Plans

POST

Indian Prepaid Recharge Plans API — Get every prepaid recharge plan an Indian mobile operator currently sells in one telecom circle, for Airtel, Jio, Vi (Vodafone Idea) and BSNL. Each plan comes back with its amount in rupees, its validity in one consistent readable form (plus validity_days whenever the validity is a fixed number of days), the operator's own benefit description and a status saying whether it is still on sale. Every plan also carries a stable category — popular, unlimited, data, topup, voice, roaming, entertainment and more — that does not change when an operator renames its own sections, with the operator's section name kept beside it as category_label for display. When the customer does not know their operator or circle, look them up first from the mobile number with the Operator and Circle Check API.

Coverage: India
Real-time telecom lookup
Structured JSON response
POST request with Bearer auth

Get API Key — Free View Full Docs

Endpoint

POST

https://app.way2api.com/api/v1/mobile/recharge-plans

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters

Parameter	Type	Required	Description
`operator`	string	Yes	Prepaid operator. Accepted values: airtel, jio, vi (Vodafone Idea), bsnl. Case, spaces and punctuation are ignored, and common alternative names such as reliance_jio, vodafone, idea and vodafone_idea are accepted.
`circle`	string	Yes	Telecom circle. Accepted values: andhra_pradesh, assam, bihar, chennai, delhi, gujarat, haryana, himachal_pradesh, jammu_kashmir, karnataka, kerala, kolkata, madhya_pradesh, maharashtra, mumbai, north_east, odisha, punjab, rajasthan, tamil_nadu, up_east, up_west, west_bengal. Case, spaces and punctuation are ignored ("UP (East)" and "J&K" both work), and a state that shares a circle resolves to that circle: goa to maharashtra, telangana to andhra_pradesh, jharkhand to bihar, chhattisgarh to madhya_pradesh, uttarakhand to up_west, sikkim to west_bengal and the north-eastern states to north_east.

Request Example

<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/mobile/recharge-plans", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "operator" => "airtel", "circle" => "karnataka" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);

curl -X POST https://app.way2api.com/api/v1/mobile/recharge-plans \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"operator":"airtel","circle":"karnataka"}'

$.ajax({ url: "https://app.way2api.com/api/v1/mobile/recharge-plans", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "operator": "airtel", "circle": "karnataka" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });

const { data } = await axios.post( "https://app.way2api.com/api/v1/mobile/recharge-plans", {"operator":"airtel","circle":"karnataka"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);

import requests response = requests.post( "https://app.way2api.com/api/v1/mobile/recharge-plans", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "operator": "airtel", "circle": "karnataka" } ) print(response.status_code) print(response.json())

Response Example

200 OK Success Response

{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "operator": "airtel",
            "circle": "karnataka",
            "plan_count": 4,
            "plans": [
                {
                    "category": "popular",
                    "category_label": "Trending Packs",
                    "amount": 399,
                    "validity": "28 days",
                    "validity_days": 28,
                    "description": "Calls : Unlimited | Data : Unlimited 5G + 2.5GB/day | SMS : 100/day | COMBO : 28 days",
                    "status": "active"
                },
                {
                    "category": "unlimited",
                    "category_label": "Unlimited 5G Plans",
                    "amount": 429,
                    "validity": "1 month",
                    "validity_days": null,
                    "description": "Calls : Unlimited local STD & Roaming | Data : Unlimited 5G + 2.5GB/day | SMS : 100/Day",
                    "status": "active"
                },
                {
                    "category": "data",
                    "category_label": "Data",
                    "amount": 77,
                    "validity": "7 days",
                    "validity_days": 7,
                    "description": "Data: 5GB | COMBO: 7 days",
                    "status": "active"
                },
                {
                    "category": "topup",
                    "category_label": "TOPUP (top up voucher)",
                    "amount": 500,
                    "validity": "",
                    "validity_days": null,
                    "description": "TOPUP : 423.73",
                    "status": "active"
                }
            ]
        }
    }
}

4xx Error Response

{
    "success": false,
    "message": "Recharge plans could not be fetched for this operator and circle right now. Please try again shortly.",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "VENDOR_ERROR"
    }
}

Common Response Codes

Code	Meaning
200	OK — Request successful
400	Bad Request — Missing or invalid parameters
401	Unauthorized — Invalid or missing API key
429	Too Many Requests — Rate limit exceeded
500	Server Error — Try again later

Ready to integrate?

Start with 1,000 free trial calls on this API. No credit card required.

Get API Key — Free Browse All APIs

Indian Prepaid Recharge Plans