Retrieve a list of Sim resources on your Account
A resource representing a Programmable Wireless SIM
Retrieve a list of Sim resources on your Account.
Query parameters
-
Status string
Only return Sim resources with this status.
Values are
new
,ready
,active
,suspended
,deactivated
,canceled
,scheduled
, orupdating
. -
Iccid string
Only return Sim resources with this ICCID. This will return a list with a maximum size of 1.
-
RatePlan string
The SID or unique name of a RatePlan resource. Only return Sim resources assigned to this RatePlan resource.
-
EId string
Deprecated.
-
SimRegistrationCode string
Only return Sim resources with this registration code. This will return a list with a maximum size of 1.
-
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/Sims
curl \
-X GET https://wireless.twilio.com/v1/Sims \
--user "username:password"
Response examples (200)
{
"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"
},
"sims": [
{
"account_sid": "string",
"commands_callback_method": "HEAD",
"commands_callback_url": "https://example.com",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"e_id": "string",
"friendly_name": "string",
"iccid": "string",
"ip_address": "string",
"links": {},
"rate_plan_sid": "string",
"reset_status": "resetting",
"sid": "string",
"sms_fallback_method": "HEAD",
"sms_fallback_url": "https://example.com",
"sms_method": "HEAD",
"sms_url": "https://example.com",
"status": "new",
"unique_name": "string",
"url": "https://example.com",
"voice_fallback_method": "HEAD",
"voice_fallback_url": "https://example.com",
"voice_method": "HEAD",
"voice_url": "https://example.com"
}
]
}
Response examples (200)
{
"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"
},
"sims": [
{
"account_sid": "string",
"commands_callback_method": "HEAD",
"commands_callback_url": "https://example.com",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"e_id": "string",
"friendly_name": "string",
"iccid": "string",
"ip_address": "string",
"links": {},
"rate_plan_sid": "string",
"reset_status": "resetting",
"sid": "string",
"sms_fallback_method": "HEAD",
"sms_fallback_url": "https://example.com",
"sms_method": "HEAD",
"sms_url": "https://example.com",
"status": "new",
"unique_name": "string",
"url": "https://example.com",
"voice_fallback_method": "HEAD",
"voice_fallback_url": "https://example.com",
"voice_method": "HEAD",
"voice_url": "https://example.com"
}
]
}