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

## Request

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

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