Mobile ROffer Fetch API
Provides live special recharge offers, plan MRP, validity, talktime, data benefits, and promotion descriptions directly from carrier systems.
POST /api/v1/roffer/fetch
~<500ms Avg Latency
99.9% Uptime SLA
x-api-key Auth
API Overview
Fetch real-time telecom recharge special offers (ROffer) for Airtel and VI prepaid mobile numbers.
Key Features & Data Points:
- Instant Authoritative Response: Fetches verified official data with ultra-low response latency (~<500ms).
- Clean JSON Standard: Normalized structure across all verification services for effortless enterprise integration.
- Enterprise SLA: Backed by NextStepApi 99.9% uptime architecture and redundant provider failover.
- Secure Header Authentication: Direct authentication via
x-api-keyrequest header.
Request Specification
Headers:
| Header Name | Type | Description |
|---|---|---|
| x-api-key* | string | Your secret production API Key obtained from your NextStepApi dashboard. |
| Content-Type* | string | Must be set to application/json. |
| x-request-id | string | Optional client-generated tracking ID (e.g. REQ12345XYZ) for idempotent logging. |
Request Body (JSON):
| Parameter | Type | Description |
|---|---|---|
| mobileNumber* | string | 10-digit Indian prepaid or postpaid mobile number. |
| operatorId* | string | Operator identifier code (e.g. 102 for Jio, 104 for Vi, 101 for Airtel). |
Request & Response Examples
Sample Request:
HTTP POST /api/v1/roffer/fetch
POST /api/v1/roffer/fetch
x-api-key: your_api_key_here
Content-Type: application/json
{
"mobileNumber": "9812345678",
"operatorId": "104"
}
Sample Response (200 OK — Sanitized Test Data):
HTTP 200 OK • application/json • <500ms
{
"code": 200,
"status": "success",
"message": "Success",
"request_id": "REQ1234567890",
"response": {
"mobile_number": "9812345678",
"operator_id": "104",
"operator_name": "VI",
"total_offers": 1,
"offers": [
{
"mrp": "179",
"validity": "28",
"voice": "Unlimited Calls",
"data": "1GB",
"description": "1GB \u002B UL calls for 28 days"
}
]
}
}
Business Use Cases
1
Recharge Platforms
Designed for mission-critical workflows requiring verified real-time data lookups.
2
Special Offer Displays
Designed for mission-critical workflows requiring verified real-time data lookups.
3
Telecom Apps
Designed for mission-critical workflows requiring verified real-time data lookups.
4
Digital Wallets
Designed for mission-critical workflows requiring verified real-time data lookups.
Integration Steps
1
Provide x-api-key header
2
POST /api/v1/roffer/fetch with mobileNumber and operatorId
3