Recharge Plans API

Ippocloud's Recharge Plans API is a complete dataset of recharge plans and offers of different telecom operators in India


To use this API, you need an API key.
Please login to your account and navigate to dashboard > API configuration

Learn how to authenticate the APIs.

Get prepaid recharge plans

Use the below endpoint to fetch prepaid recharge plans

/plans/mobile/prepaid-plans
curl -X POST https://ippocloud.com/api/v1
/plans/mobile/prepaid-plans
-H "Authorization: Basic bGl2ZV82MzAzZT...."
-H "Content-Type: application/json"
-d "{\"operator_code\":\"RP\", \"circle_code\":\"KA\"}"
$url = "https://ippocloud.com/api/v1
/plans/mobile/prepaid-plans";
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$headers = array(
   "Authorization: Basic bGl2ZV82MzAzZT....",
   "Content-Type: application/json",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
$data = '{"operator_code":"RP", "circle_code":"KA"}';
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
var url = "https://ippocloud.com/api/v1
/plans/mobile/prepaid-plans";
var xhr = new XMLHttpRequest();
xhr.open("POST", url);
xhr.setRequestHeader("Authorization", "Basic bGl2ZV82MzAzZT....");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.onreadystatechange = function () {
   if (xhr.readyState === 4) {
      console.log(xhr.status);
      console.log(xhr.responseText);
   }};
var data = '{"operator_code":"RP", "circle_code":"KA"}';
xhr.send(data);
import requests
from requests.structures import CaseInsensitiveDict
url = "https://ippocloud.com/api/v1
/plans/mobile/prepaid-plans"
headers = CaseInsensitiveDict()
headers["Authorization"] = "Basic bGl2ZV82MzAzZT...."
headers["Content-Type"] = "application/json"
data = '{"operator_code":"RP", "circle_code":"KA"}'
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
URL url = new URL("https://ippocloud.com/api/v1
/plans/mobile/prepaid-plans");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setRequestProperty("Authorization", "Basic bGl2ZV82MzAzZT....");
http.setRequestProperty("Content-Type", "application/json");
String data = "{\"operator_code\":\"RP\", \"circle_code\":\"KA\"}";
byte[] out = data.getBytes(StandardCharsets.UTF_8);
OutputStream stream = http.getOutputStream();
stream.write(out);
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();
var url = "https://ippocloud.com/api/v1
/plans/mobile/prepaid-plans";
var httpRequest = (HttpWebRequest)WebRequest.Create(url);
httpRequest.Method = "POST";
httpRequest.Headers["Authorization"] = "Basic bGl2ZV82MzAzZT....";
httpRequest.ContentType = "application/json";
var data = "{\"operator_code\":\"RP\", \"circle_code\":\"KA\"}";
using (var streamWriter = new StreamWriter(httpRequest.GetRequestStream()))
{
   streamWriter.Write(data);
}
var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
   var result = streamReader.ReadToEnd();
}
Console.WriteLine(httpResponse.StatusCode);
{
    "data": {
        "entity": "prepaid_plans",
        "operator": "Jio",
        "circle": "Karnataka",
        "categories": [{
            "entity": "collection",
            "name": "Unlimited",
            "count": 21,
            "items": [{
                "entity": "plan",
                "plan_id": 6135,
                "amount": 119,
                "validity": "14 days",
                "talktime": "0",
                "benefit": "1.5 GB\/day data + Unlimited calls +
                            300 SMS + JioTV, JioCinema, JioSecurity,
                            JioCloud apps subscriptions",
                "calls": "Unlimited",
                "sms": "300",
                "data": "1.5 GB\/day",
                "remark": "",
                "subscriptions": [{
                    "entity": "subscription",
                    "name": "JioTV",
                    "description": "Your daily dose of entertainment
                                    on the app",
                    "logo": "jio_tv.png"
                }, {
                    "entity": "subscription",
                    "name": "JioCinema",
                    "description": "Movies, Tv shows, music
                                 and more on the app",
                    "logo": "jio_cinema.png"
                }, ..........]
            }, ..........]
        }, ..........]
    }
}

Request parameters

operator_code

mandatory

string The unique two-digit code of the operator. For example, RP

circle_code

mandatory

string The unique two-digit code of the circle. KA

Response Parameters

data

object contains all the details of the operator, circle, categories

categories

array collection of categories, category name, number of prepaid plans and prepaid plans

items

array contains prepaid plan objects. entity, plan_id, amount, validity, talktime, benefit, calls, sms, data, remark

subscriptions

array contains the offers and free subscriptions offered by the telecom operator. entity, name, description, logo

Circle Codes

Here is a list of India's 22 telecom circles, including Metro, A, B, and C category service areas. Officially, telecom circles are now called telecom 'service areas', but both terms used to mean the same thing.

Circle name

Circle code

Andhra Pradesh & Telangana

AP

Assam

AS

Bihar Jharkhand

BR

Chennai

CH

Delhi & NCR

DL

Gujarat

GJ

Haryana

HR

Himachal Pradesh

HP

Jammu & Kashmir

JK

Karnataka

KA

Kerala

KL

Kolkata

KO

Madhya Pradesh & Chhattisgarh

MP

Maharashtra & Goa

MH

Mumbai

MU

North East

NE

Odisha

OR

Punjab

PB

Rajasthan

RJ

Tamil Nadu

TN

Uttar Pradesh East

UE

Uttar Pradesh West & Uttarakhand

UW

West Bengal

WB

Do you need help to implement this API? contact us