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

# Cancel an eSIM based on ICCID

`POST /api/v1/eSIM/cancel`

Cancels the current Matching ID for the QR code associated with a given ICCID, provided its state is set to “released”. The API requires both the ICCID and the Matching ID

## Request body

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

## Response `200`

Successfully cancelled 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

## Other responses

- `400` — Bad request, invalid ICCID format, or the ICCID state is not "released".
- `500` — Internal server error, failed to cancel the order or other issues.

---

[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/versions/150b75e17112/schema)