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
-
Only return Sim resources with this status.
Values are
new
,ready
,active
,suspended
,deactivated
,canceled
,scheduled
, orupdating
. -
Only return Sim resources with this ICCID. This will return a list with a maximum size of 1.
-
The SID or unique name of a RatePlan resource. Only return Sim resources assigned to this RatePlan resource.
-
Deprecated.
-
Only return Sim resources with this registration code. This will return a list with a maximum size of 1.
-
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.
curl \
--request GET 'https://wireless.twilio.com/v1/Sims' \
--user "username:password"
{
"meta": {
"key": "sims",
"url": "https://wireless.twilio.com/v1/Sims?Status=new&Iccid=iccid&RatePlan=rate_plan&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://wireless.twilio.com/v1/Sims?Status=new&Iccid=iccid&RatePlan=rate_plan&PageSize=50&Page=0",
"previous_page_url": null
},
"sims": []
}
{
"meta": {
"key": "sims",
"url": "https://wireless.twilio.com/v1/Sims?Status=new&Iccid=iccid&RatePlan=rate_plan&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://wireless.twilio.com/v1/Sims?Status=new&Iccid=iccid&RatePlan=rate_plan&PageSize=50&Page=0",
"previous_page_url": null
},
"sims": [
{
"sid": "DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://wireless.twilio.com/v1/Sims/DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"e_id": "e_id",
"iccid": "iccid",
"links": {
"rate_plan": "https://wireless.twilio.com/v1/RatePlans/WPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"data_sessions": "https://wireless.twilio.com/v1/Sims/DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/DataSessions",
"usage_records": "https://wireless.twilio.com/v1/Sims/DEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/UsageRecords"
},
"status": "new",
"sms_url": "http://www.example.com",
"voice_url": "http://www.example.com",
"ip_address": "192.168.1.30",
"sms_method": "POST",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"unique_name": "unique_name",
"date_created": "2015-07-30T20:00:00Z",
"date_updated": "2015-07-30T20:00:00Z",
"reset_status": "resetting",
"voice_method": "POST",
"friendly_name": "friendly_name",
"rate_plan_sid": "WPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sms_fallback_url": "http://www.example.com",
"voice_fallback_url": "http://www.example.com",
"sms_fallback_method": "POST",
"commands_callback_url": "http://www.example.com",
"voice_fallback_method": "POST",
"commands_callback_method": "POST"
}
]
}