---
title: "Get eSIM by ICCID"
method: GET
path: "/api/v1/eSIM/getByIccid/{iccid}"
tags: ["eSIM"]
---

# Get eSIM by ICCID

`GET /api/v1/eSIM/getByIccid/{iccid}`

Returns the Subscription information associated with the provided ICCID.

## Path parameters

- `iccid` string, required

## Response `200`

Successfully fetched profile information for the given ICCID.

- object
  - `data` object
    - `activationCode` string — The activation code associated with the ICCID.
    - `iccid` string — ICCID with the checksum removed
    - `imei` string — The IMEI associated with the device.
    - `imsi` string — The IMSI (International Mobile Subscriber Identity) associated with the ICCID.
    - `matchingId` string — A matching identifier for the profile.
    - `qr_code` string — The QR code associated with the profile.
    - `state` string — The state of the profile.

## Other responses

- `400` — Bad request, invalid ICCID format or validation failure.
- `500` — Internal server error, failed to fetch profile 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/revisions/150b75e17112/schema)