Skip to Content
Flexylik Télécomv3
Dashboard
GuidesAPI reference
Mobile top up

List plans

GET
/v3/mobile/plans

Plans you can send. dynamicPlans take an amount between min_amount and max_amount. offerPlans (OFFER_*) need an offer_id from GET /v3/mobile/offers. Safe to cache for a few minutes.

Authorization

AccessToken
headerX-Access-Token<token>

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

Response Body

Available plans

application/json
  1. response
success*true
Value intrue
data*
meta*
requestId*string
Example Request
curl -X GET 'https://api.flexyliktelecom.com/v3/mobile/plans'
Example Response
{  "success": true,  "data": {    "dynamicPlans": [      {        "code": "PREPAID_DJEZZY",        "name": "Djezzy prepaid credit",        "operator": "Mobilis",        "type": "topup",        "isEnabled": true,        "min_amount": 100,        "max_amount": 50000      }    ],    "fixedPlans": [      {        "property1": null,        "property2": null      }    ],    "offerPlans": [      {        "code": "OFFER_MOBILIS",        "name": "Mobilis offers and packages",        "operator": "Mobilis",        "type": "offer",        "isEnabled": true,        "requires": "offer_id"      }    ]  },  "meta": {    "timestamp": "2026-11-15T10:30:00.000Z"  },  "requestId": "req_8fK2mQx7Lp0aZ3nV1cWb"}

List offers for a number GET

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.

Answer a line-debt question POST

When a top-up is DEBT_PENDING the operator reported an unpaid line debt (SABBAQLI) and waits for a decision. Choose PAY_ALL, PAY_OPERATION_ONLY, PAY_DEBT_ONLY or CANCEL; debt_options on the top-up shows what each costs. The top-up then continues (PENDING → … → COMPLETED) or ends REFUNDED for CANCEL. Unanswered top-ups are cancelled at debt_expires_at.