Retrieve a list of eSIM Profiles
eSIM Profiles that can be loaded onto consumer eUICC SIMs
Retrieve a list of eSIM Profiles.
Query parameters
-
Eid string
List the eSIM Profiles that have been associated with an EId.
-
SimSid string
Find the eSIM Profile resource related to a Sim resource by providing the SIM SID. Will always return an array with either 1 or 0 records.
-
Status string
List the eSIM Profiles that are in a given status.
Values are
new
,reserving
,available
,downloaded
,installed
, orfailed
. -
PageSize integer
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
.
GET /v1/ESimProfiles
curl \
-X GET https://supersim.twilio.com/v1/ESimProfiles \
--user "username:password"
Response examples (200)
{
"esim_profiles": [
{
"account_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"eid": "string",
"error_code": "string",
"error_message": "string",
"iccid": "string",
"sid": "string",
"sim_sid": "string",
"smdp_plus_address": "https://example.com",
"status": "new",
"url": "https://example.com"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}
Response examples (200)
{
"esim_profiles": [
{
"account_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"eid": "string",
"error_code": "string",
"error_message": "string",
"iccid": "string",
"sid": "string",
"sim_sid": "string",
"smdp_plus_address": "https://example.com",
"status": "new",
"url": "https://example.com"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}