Mobile R-Offer Fetch

Telecom
POST /api/v1/mobile/r-offer Bearer

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.

Availability

🗺 Country-specific

India

What Mobile R-Offer Fetch Is Used For

Personalised recharge offers

Show a customer the R-Offers loaded against their own number rather than a generic plan list.

Retailer applications

Let a shop assistant read out the best available offer for the number in front of them.

Conversion improvement

Surface a number-specific discount at checkout to lift recharge completion.

Margin management

Compare offer price against face value before deciding what to promote.

Quick Start

1. Copy your API key from Dashboard → API Keys
2. Send a POST request to /api/v1/mobile/r-offer
3. Pass the key as Authorization: Bearer <key>
4. Read the result from the data object in the JSON response

cURL

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"}'
🚀 Send Request
✓ Key saved

🔑 Remember API Key

One-click convenience for testing & troubleshooting — no account needed.

1

What it doesSaves your API key in this browser only using localStorage. Next time you open a docs page, the Try It panel is pre-filled automatically.

2

Auto-updatesIf you type a different key into any Try It field, the saved key is replaced instantly — only the most recent key is ever stored.

3

Uncheck to forgetUnchecking “Remember API Key” immediately deletes the stored key and clears the field. While unchecked, nothing is saved even if you type a new key.

4

Re-check to save againChecking the box again saves whatever key is currently in the Try It field.

⚠ Security note: Your key is stored only in your browser and is never sent to any server except as part of the actual API call you send. Do not use this feature on shared or public computers.

More on this API

Request Endpoint, authentication headers, every request parameter with its type, and a sample request body. Response The full success response payload, field by field. Error Codes HTTP status codes, error payload shape, and how to handle failures. Code Examples Ready-to-run examples in cURL, PHP, JavaScript and Python. Rate Limits Per-minute and per-day request limits, and what happens on breach. AI Agent / LLM The whole endpoint as one Markdown brief — paste into Claude, Cursor, Copilot or ChatGPT.