---
title: "Fetch an eSIM Profile."
method: GET
path: "/v1/ESimProfiles/{Sid}"
tags: ["SupersimV1EsimProfile"]
---

# Fetch an eSIM Profile.

`GET /v1/ESimProfiles/{Sid}`

## Request

- Base URL: `https://supersim.twilio.com`
- URL: `https://supersim.twilio.com/v1/ESimProfiles/{Sid}`
- Auth: HTTP basic

Fetch an eSIM Profile.

## Path parameters

- `Sid` string, required

## Response `200`

OK

- SupersimV1EsimProfile
  - `sid` string, nullable: The unique string that we created to identify the eSIM Profile resource.
  - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) to which the eSIM Profile resource belongs.
  - `iccid` string, nullable: The [ICCID](https://en.wikipedia.org/wiki/Subscriber_identity_module#ICCID) associated with the Sim resource.
  - `sim_sid` string, nullable: The SID of the [Sim](https://www.twilio.com/docs/iot/supersim/api/sim-resource) resource that this eSIM Profile controls.
  - `status` 'new' | 'reserving' | 'available' | 'downloaded' | 'installed' | 'failed': The status of the eSIM Profile. Can be: `new`, `reserving`, `available`, `downloaded`, `installed` or `failed`. See the [eSIM Profile Status Values](https://www.twilio.com/docs/iot/supersim/api/esimprofile-resource#status-values) for a description of each.
  - `eid` string, nullable: Identifier of the eUICC that can claim the eSIM Profile.
  - `smdp_plus_address` string, uri, nullable: Address of the SM-DP+ server from which the Profile will be downloaded. The URL will appear once the eSIM Profile reaches the status `available`.
  - `matching_id` string, nullable: Unique identifier of the eSIM profile that can be used to identify and download the eSIM profile from the SM-DP+ server. Populated if `generate_matching_id` is set to `true` when creating the eSIM profile reservation.
  - `activation_code` string, nullable: Combined machine-readable activation code for acquiring an eSIM Profile with the Activation Code download method. Can be used in a QR code to download an eSIM profile.
  - `error_code` string, nullable: Code indicating the failure if the download of the SIM Profile failed and the eSIM Profile is in `failed` state.
  - `error_message` string, nullable: Error message describing the failure if the download of the SIM Profile failed and the eSIM Profile is in `failed` state.
  - `date_created` string, date-time, nullable: The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable: The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `url` string, uri, nullable: The absolute URL of the eSIM Profile resource.

## Changes

- **2023-08-10** (v1) `4c8f6063ae9d`: 1 info
  - api tag `SupersimV1EsimProfile` added
- **2023-03-09** (v1) `68030faeddb4`: 2 info
  - added the optional property `activation_code` to the response with the `200` status
  - added the optional property `matching_id` to the response with the `200` status

[Operation history](https://skmtc.dev/twilio/apis/supersim-v1/changes/v1/ESimProfiles/:Sid/get.md)

---

[API](https://skmtc.dev/twilio/apis/supersim-v1.md) - [All operations](https://skmtc.dev/twilio/apis/supersim-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/supersim-v1/revisions/c0baa6eaf932?raw)