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

## Request

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

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.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)