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

## Changes

- **2025-02-20** (v1) `40aef886b303` — 1 breaking
  - for the `query` request parameter `PageSize`, the format changed from no format to `int64`
- **2023-08-10** (v1) `4c8f6063ae9d` — 1 info
  - api tag `SupersimV1EsimProfile` added
- **2023-03-09** (v1) `68030faeddb4` — 2 info
  - added the optional property `esim_profiles/items/activation_code` to the response with the `200` status
  - added the optional property `esim_profiles/items/matching_id` to the response with the `200` status
- **2023-02-02** (v1) `a6e2859a656d` — 2 info
  - added the new optional `query` request parameter `Page`
  - added the new optional `query` request parameter `PageToken`
- **2023-01-13** (v1) `42d026552cc2` — 2 breaking
  - the response property `meta/next_page_url` became nullable for the status `200`
  - the response property `meta/previous_page_url` became nullable for the status `200`

[Change history](https://skmtc.dev/twilio/apis/supersim-v1/changes/v1/ESimProfiles/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-service-production.skmtc.workers.dev/v1/apis/twilio/supersim-v1/revisions/c0baa6eaf932/schema)