---
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`

## Request

- Base URL: `https://api.monogoto.io`
- URL: `https://api.monogoto.io/api/v1/eSIM/download`
- Auth: none required
- TypeScript: <https://skmtc.dev/monogoto/apis/monogoto-softsim-apis/docs/api/v1/eSIM/download/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/monogoto/apis/monogoto-softsim-apis.md) - [All operations](https://skmtc.dev/monogoto/apis/monogoto-softsim-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/monogoto/apis/monogoto-softsim-apis/revisions/150b75e17112?raw)