Skip to Content
Mobile top up

List offers for a number

GET
/v3/mobile/offers

Asks the operator which offers (packages, internet bundles) a number can receive. Each offer has a signed offer_id, valid 30 minutes, to send with plan_code OFFER_<OPERATOR>. This call can take a few seconds.

Authorization

AccessToken
headerX-Access-Token<token>

Your API key. Sandbox keys start with flx_test_, production keys with flx_live_.

Query Parameters

operator*string
Value in"mobilis""djezzy""ooredoo"
MSSIDN*string

Algerian mobile number with leading 0, no spaces, no +213. 05 Ooredoo, 06 Mobilis, 07 Djezzy, 01 Ooredoo Enterprise (OOREDOO plans only).

Match^0[1567]\d{8}$

Response Body

Offers for this number

application/json
  1. response
success*true
Value intrue
data*
meta*
requestId*string
Example Request
curl -X GET 'https://api.flexyliktelecom.com/v3/mobile/offers?operator=mobilis&MSSIDN=0600000009'
Example Response
{  "success": true,  "data": {    "MSSIDN": "0600000009",    "operator": "Mobilis",    "plan_code": "OFFER_MOBILIS",    "expires_at": "2026-11-15T11:00:00.000Z",    "offers": [      {        "offer_id": "eyJ2IjoxLC4uLn0.q8Zr…",        "name": "Mix 500",        "amount": 500,        "debt_amount": 0,        "total_amount": 500,        "category": "regular"      }    ]  },  "meta": {    "timestamp": "2026-11-15T10:30:00.000Z"  },  "requestId": "req_8fK2mQx7Lp0aZ3nV1cWb"}