Telecom API

Mobile R-Offer Fetch

Retrieve the R-Offers (special, number-specific recharge offers) that a telecom operator has loaded against one prepaid mobile number.

Mobile R-Offer Fetch
POST

Mobile R-Offer Fetch API — Retrieve the R-Offers (special, number-specific recharge offers) that a telecom operator has loaded against one prepaid mobile number. Unlike a generic plan list, R-Offers are personalised per number, so the same recharge amount can carry different benefits for different subscribers. Returns an offers array where each entry has the price, a customer-friendly description, and the operator log_description (the exact benefit text). Ideal for recharge platforms and retailer apps that want to surface the best available offer before a top-up. Currently supported for Airtel and VI (Vodafone Idea) prepaid numbers only.

  • 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/r-offer

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
mobile_number string Yes 10-digit Indian mobile number — format: [6-9][0-9]{9} (e.g. 9876543210)
operator string Yes Prepaid operator of the number. Accepted values: airtel, vi (Vodafone Idea). Other operators (jio, bsnl) are not supported by the source yet and are rejected without charge.
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/mobile/r-offer", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "mobile_number" => "9876543210", "operator" => "airtel" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/mobile/r-offer", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "mobile_number": "9876543210", "operator": "airtel" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
curl -X POST https://app.way2api.com/api/v1/mobile/r-offer \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{\"mobile_number\":\"9876543210\",\"operator\":\"airtel\"}'
$.ajax({ url: "https://app.way2api.com/api/v1/mobile/r-offer", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "mobile_number": "9876543210", "operator": "airtel" }), 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/r-offer", {"mobile_number":"9876543210","operator":"airtel"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/mobile/r-offer", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "mobile_number": "9876543210", "operator": "airtel" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "mobile_number": "9876543210",
            "operator": "airtel",
            "offers": [
                {
                    "price": "29",
                    "description": "Stay connected with 2GB data at just Rs29",
                    "log_description": "RC29=Payein 2GB data 1 din ke liye."
                },
                {
                    "price": "65",
                    "description": "Stay connected with 4GB data at just Rs65",
                    "log_description": "65=4GB aapke maujooda pack ki vaidhta tak manya"
                }
            ]
        }
    }
}
4xx Error Response 
{
    "success": false,
    "message": "No offer found for this number",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "1"
    }
}
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 free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login