---
title: "Download an eSIM based on ICCID"
method: POST
path: "/api/v1/eSIM/download"
tags: ["eSIM"]
---

# Download an eSIM based on ICCID

`POST /api/v1/eSIM/download`

Downloads generate a new Matching ID to a QR code associated with a given ICCID, provided its state is set to “available”. The API requires ICCID

## Request body

- object
  - `iccid` string — The ICCID (19 or 20 characters) associated with the order to download.

## Response `200`

Successfully downloaded and confirmed the order.

- object
  - `data` object — The response data containing the cancellation details.
    - `header` object — contains value of functionExecutionStatus.
      - `functionExecutionStatus` object — contains value of status of cancellation.
        - `status` string — Status of order cancellation
    - `matchingId` string — matchingId of SIM

## Other responses

- `400` — Bad request, invalid ICCID format, or missing required parameters.
- `500` — Internal server error, failed to download or confirm the order.

---

[API](https://skmtc.net/monogoto/apis/monogoto-softsim-apis.md) · [All operations](https://skmtc.net/monogoto/apis/monogoto-softsim-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monogoto/monogoto-softsim-apis/revisions/150b75e17112/schema)