Retrieve a list of eSIM Profiles.
eSIM Profiles that can be loaded onto consumer eUICC SIMs
Retrieve a list of eSIM Profiles.
Query parameters
-
List the eSIM Profiles that have been associated with an EId.
-
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.
-
List the eSIM Profiles that are in a given status.
Values are
new
,reserving
,available
,downloaded
,installed
, orfailed
. -
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
. -
The page index. This value is simply for client state.
Minimum value is
0
. -
The page token. This is provided by the API.
GET
/v1/ESimProfiles
curl \
--request GET 'https://supersim.twilio.com/v1/ESimProfiles' \
--user "username:password"
Response examples (200)
Read all
{
"meta": {
"key": "esim_profiles",
"url": "https://supersim.twilio.com/v1/ESimProfiles?PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://supersim.twilio.com/v1/ESimProfiles?PageSize=50&Page=0",
"previous_page_url": null
},
"esim_profiles": [
{
"eid": "89049032005008882600033489aaaaaa",
"sid": "HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://supersim.twilio.com/v1/ESimProfiles/HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"iccid": "8988307aaaaaaaaaaaaa",
"status": "available",
"sim_sid": "HSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"error_code": null,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"matching_id": null,
"date_created": "2020-09-01T20:00:00Z",
"date_updated": "2020-09-01T20:00:00Z",
"error_message": null,
"activation_code": null,
"smdp_plus_address": "sm-dp-plus.twilio.com"
}
]
}
{
"meta": {
"key": "esim_profiles",
"url": "https://supersim.twilio.com/v1/ESimProfiles?Eid=89049032005008882600033489aaaaaa&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://supersim.twilio.com/v1/ESimProfiles?Eid=89049032005008882600033489aaaaaa&PageSize=50&Page=0",
"previous_page_url": null
},
"esim_profiles": [
{
"eid": "89049032005008882600033489aaaaaa",
"sid": "HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://supersim.twilio.com/v1/ESimProfiles/HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"iccid": "8988307aaaaaaaaaaaaa",
"status": "available",
"sim_sid": "HSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"error_code": null,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"matching_id": null,
"date_created": "2020-09-01T20:00:00Z",
"date_updated": "2020-09-01T20:00:00Z",
"error_message": null,
"activation_code": null,
"smdp_plus_address": "sm-dp-plus.twilio.com"
}
]
}
{
"meta": {
"key": "esim_profiles",
"url": "https://supersim.twilio.com/v1/ESimProfiles?SimSid=HSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://supersim.twilio.com/v1/ESimProfiles?SimSid=HSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
"previous_page_url": null
},
"esim_profiles": [
{
"eid": "89049032005008882600033489aaaaaa",
"sid": "HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://supersim.twilio.com/v1/ESimProfiles/HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"iccid": "8988307aaaaaaaaaaaaa",
"status": "available",
"sim_sid": "HSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"error_code": null,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"matching_id": null,
"date_created": "2020-09-01T20:00:00Z",
"date_updated": "2020-09-01T20:00:00Z",
"error_message": null,
"activation_code": null,
"smdp_plus_address": "sm-dp-plus.twilio.com"
}
]
}
{
"meta": {
"key": "esim_profiles",
"url": "https://supersim.twilio.com/v1/ESimProfiles?Status=downloaded&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://supersim.twilio.com/v1/ESimProfiles?Status=downloaded&PageSize=50&Page=0",
"previous_page_url": null
},
"esim_profiles": [
{
"eid": "89049032005008882600033489aaaaaa",
"sid": "HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://supersim.twilio.com/v1/ESimProfiles/HPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"iccid": "8988307aaaaaaaaaaaaa",
"status": "downloaded",
"sim_sid": "HSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"error_code": null,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"matching_id": null,
"date_created": "2020-09-01T20:00:00Z",
"date_updated": "2020-09-01T20:00:00Z",
"error_message": null,
"activation_code": null,
"smdp_plus_address": "sm-dp-plus.twilio.com"
}
]
}