> ## Documentation Index
> Fetch the complete documentation index at: https://developers.mioesim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api_esim/queryIccidInformation — Batch query cards

> Query card status, expiry date, renewal eligibility, and card type for up to 100 ICCIDs in a single request. Returns a result object per ICCID.

Look up card metadata for one or more ICCIDs in a single call. Each result indicates whether the query succeeded and includes the card's expiry date, renewal eligibility, card type, and status.

```
GET https://bpm.mioesim.com/api_esim/queryIccidInformation
```

## Request parameters

<ParamField query="token" type="string" required>Session token.</ParamField>
<ParamField query="iccids" type="string" required>Comma-separated list of ICCIDs. Maximum 100 per request.</ParamField>
<ParamField query="sign" type="string" required>Request signature.</ParamField>

## Response fields

<ResponseField name="data" type="array">
  One entry per ICCID queried.

  <Expandable title="Card info fields">
    <ResponseField name="success" type="boolean">Whether the query for this ICCID succeeded.</ResponseField>
    <ResponseField name="message" type="string">Result message (e.g. `"Query successful"`).</ResponseField>
    <ResponseField name="iccid" type="string">The queried ICCID.</ResponseField>
    <ResponseField name="expireTime" type="string">Card expiry date/time.</ResponseField>
    <ResponseField name="canRenew" type="boolean">Whether the card supports plan renewal.</ResponseField>
    <ResponseField name="cardType" type="integer">`0` = eSIM, `1` = physical SIM.</ResponseField>
    <ResponseField name="displayName" type="string">Card brand name (e.g. `"FiROAM"`).</ResponseField>
    <ResponseField name="dpId" type="string">Distribution partner ID.</ResponseField>
    <ResponseField name="dpStatus" type="string">Card status (ACTIVE, Disable, Delete, Enable).</ResponseField>
    <ResponseField name="eid" type="string">EID (device identifier, if available).</ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://bpm.mioesim.com/api_esim/queryIccidInformation?token=YOUR_TOKEN&iccids=898520302104038975,898520302104038976&sign=YOUR_SIGN"
  ```

  ```json Success theme={null}
  {
    "code": "0",
    "message": "success",
    "data": [
      {
        "success": true,
        "message": "Query successful",
        "iccid": "898520302104038975",
        "expireTime": "2026-03-06 00:00:00",
        "canRenew": true,
        "cardType": 0,
        "displayName": "FiROAM",
        "dpId": "21",
        "dpStatus": null,
        "eid": null
      },
      {
        "success": true,
        "message": "Query successful",
        "iccid": "898520302104038976",
        "expireTime": "2026-03-06 00:00:00",
        "canRenew": true,
        "cardType": 0,
        "displayName": "FiROAM",
        "dpId": "21"
      }
    ]
  }
  ```
</CodeGroup>