> ## 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/getHistoryDetail — ICCID historical packages

> Retrieve the full package history for a SIM card by ICCID, including past plan orders, usage data, and start and end dates for each plan.

Get the complete list of past and current plan orders for a specific SIM card. Each entry shows the plan details, usage, and dates — useful for displaying a customer's usage history.

```
GET http://bpm.mioesim.com/api_esim/getHistoryDetail
```

## Request parameters

<ParamField query="token" type="string" required>Session token.</ParamField>
<ParamField query="iccid" type="string" required>The ICCID of the SIM card.</ParamField>
<ParamField query="sign" type="string" required>Request signature.</ParamField>

## Response fields

<ResponseField name="data" type="array">
  List of historical plan orders (EsimOrderVo).

  <Expandable title="Order fields">
    <ResponseField name="orderNum" type="string">Order number.</ResponseField>
    <ResponseField name="skuId" type="integer">SKU ID.</ResponseField>
    <ResponseField name="skuName" type="string">SKU name.</ResponseField>
    <ResponseField name="type" type="integer">`0` = regular order, `1` = DayPass order.</ResponseField>
    <ResponseField name="count" type="integer">Quantity.</ResponseField>
    <ResponseField name="createTime" type="string">Order creation time.</ResponseField>
    <ResponseField name="status" type="integer">Order status. See [Order Statuses](/reference/order-statuses).</ResponseField>
    <ResponseField name="renew" type="boolean">Whether this is a renewal order.</ResponseField>

    <ResponseField name="packageList" type="array">
      Plan details: `flows`, `unit`, `days`, `usedMb`, `name`, `beginDate`, `endDate`, `status`, `supportDaypass`, `canActive`, `showOverTip`, `renew`.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "http://bpm.mioesim.com/api_esim/getHistoryDetail?token=YOUR_TOKEN&iccid=89480100000xxxxxxxx&sign=YOUR_SIGN"
  ```

  ```json Success theme={null}
  {
    "code": "0",
    "message": "success",
    "data": [
      {
        "orderNum": "EP20260113000002",
        "skuId": 16,
        "skuName": "South Korea",
        "type": 0,
        "count": 1,
        "createTime": "2026-01-13 19:54:35.0",
        "status": 0,
        "renew": false,
        "packageList": [
          {
            "flows": 1, "unit": "GB", "days": 3,
            "usedMb": 0.0, "name": "1GB/3days",
            "beginDate": "2026-01-14 17:26",
            "endDate": "2026-01-15 17:26",
            "status": 1
          }
        ]
      }
    ]
  }
  ```
</CodeGroup>