GET /api_esim/getESIMDetail — ICCID usage and card status

This endpoint returns comprehensive information about a SIM card: current usage in MB, supported networks, card status, active and historical plans, and company branding info. It is intended for building customer-facing eSIM management interfaces.

GET http://bpm.mioesim.com/api_esim/getESIMDetail

This endpoint requires your server’s IP address to be added to the MIOeSIM whitelist. Contact help@mioesim.com before using it. Unauthorized IPs will receive a 400108 (Access denied) error.

This endpoint uses HTTP (not HTTPS) and does not require token or sign. Authentication is by IP whitelist only.

Request parameters

string

required

The ICCID of the SIM card.

Response fields

object

Show Top-level fields

object

Card identity: iccid, number (phone number), createDate, expireDate, supportRenew, eid, dpStatus (ACTIVE / Disable / Delete / Enable).

object

Map of country name → array of supported networks (countryCode, type: 3G/LTE/5G, operator, name).

array

Active and recent plan orders. Each entry includes orderNum, skuName, type, status, createTime, and packageList (flows, unit, days, usedMb, beginDate, endDate, status).

object

Branding info: name, logoUrl, slogan.

array

Countries grouped by continent: continent, countryNames.

Example

curl "http://bpm.mioesim.com/api_esim/getESIMDetail?iccid=89480100000xxxxxxxx"

{
  "code": 1,
  "message": "success",
  "status": "Success",
  "data": {
    "esimInfo": {
      "iccid": "89480100000xxxxxxxx",
      "number": "xxx6335xxxx",
      "expireDate": "2026-03-24",
      "supportRenew": false,
      "dpStatus": "Delete"
    },
    "supportNetwork": {
      "Kazakhstan": [
        { "countryCode": 398, "type": "5G", "operator": "Tele2" },
        { "countryCode": 398, "type": "LTE", "operator": "Beeline" }
      ]
    },
    "esimPackets": [
      {
        "orderNum": "EP20251215000285",
        "skuName": "Kazakhstan",
        "status": 5,
        "packageList": [
          { "flows": 3, "unit": "GB", "days": 7, "usedMb": 3038.57, "status": 2 }
        ]
      }
    ]
  }
}

{ "code": 400108, "message": "Access denied", "data": null, "status": "Fail" }

Authentication

eSIM Products

Orders

Physical SIM

ICCID & Cards

Account

By API Code

GET /api_esim/getESIMDetail — ICCID usage and card status

Request parameters

Response fields

Example

​Request parameters

​Response fields

​Example

Request parameters

Response fields

Example