---
title: "Retrieve a list of eSIM Profiles."
method: GET
path: "/v1/ESimProfiles"
tags: ["SupersimV1EsimProfile"]
---

# Retrieve a list of eSIM Profiles.

`GET /v1/ESimProfiles`

Retrieve a list of eSIM Profiles.

## Query parameters

- `Eid` string
- `SimSid` string
- `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.
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `esim_profiles` 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.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

---

[API](https://skmtc.net/twilio/apis/supersim-v1.md) · [All operations](https://skmtc.net/twilio/apis/supersim-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/supersim-v1/revisions/c0baa6eaf932/schema)