# Get an eSIM (/docs/api-reference/esims/get-esim)

`GET /v1/esims/{iccid}/profile`

Returns one of your eSIMs by its ICCID, with its installation details, plan and top-ups.

Returns the eSIM as last recorded, without a live refresh: `esimStatus` and `profileStatus` as the
order item names them, the SIM details (LPA code, QR code URL and quick-install links), the plan, its data
(MB), SMS (messages) and voice (minutes) allowances, any top-ups, and `expiresAt`, null until the eSIM is
activated. An ICCID that is not one of your eSIMs gives 404 / 10004.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `iccid` | path | yes | `string` | The eSIM's ICCID, from the order item's `fulfillment.result.details.iccid`. |

## Responses

### 200

OK

- `text/plain`: `EsimProfile`
- `application/json`: `EsimProfile`
- `text/json`: `EsimProfile`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 404

Not Found

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 500

Internal Server Error

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.