Network Resource
A Network resource represents a cellular network to which Super SIMs can connect.
You can obtain a list of all available mobile operator networks, provided as an array of Network resources, from this endpoint:
https://supersim.twilio.com/v1/Networks
To allow Super SIMs to connect to the cellular network that a Network resource represents, the Network resource must be included in a Network Access Profile resource’s Networks subresource.
Network properties
| Resource Properties in REST API format | |
|---|---|
sid
|
The unique string that we created to identify the Network resource. |
friendly_name
|
A human readable identifier of this resource. |
url
|
The absolute URL of the Network resource. |
iso_country
|
The ISO country code of the Network resource. |
identifiers
|
Array of objects identifying the MCC-MNCs that are included in the Network resource. |
The identifiers property
A Network resource’s identifiers property is an array of objects that contain identifiers for all of the public land mobile networks (PLMNs) that are represented by a Network resource.
mcc |
The Mobile Country Code (MCC) is the unique ID that identifies the mobile operator network’s home country. |
mnc |
The Mobile Network Code (MNC) is the unique ID that identifies the mobile operator network. |
There have been many mergers, spin-offs, and rebrandings of mobile network operators around the world. A PLMN may therefore have many identifiers, i.e., multiple MCC and MNC pairings. A PLMN’s trading name may no longer match the ‘friendly name’ which is used to identify it in a human-readable way to other PLMNs and which is recorded in a Network resource’s friendly_name property.
If there is a specific mobile network operator you are looking for which may have a different name to the Network resource’s friendly_name property, check if its MCC and MNC IDs are included among a Network resource’s identifiers.
Fetch a Network resource
https://supersim.twilio.com/v1/Networks/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
sid
Path
|
The SID of the Network resource to fetch. |
Example 1
Read multiple Network resources
https://supersim.twilio.com/v1/Networks
Parameters
| Parameters in REST API format | |
|---|---|
iso_country
Optional
|
The ISO country code of the Network resources to read. |
mcc
Optional
|
The 'mobile country code' of a country. Network resources with this |
mnc
Optional
|
The 'mobile network code' of a mobile operator network. Network resources with this |
Example 1
Example 2
You can use the a cellular network’s MCC-MNC to search for a specific network. For example, one of AT&T US’ MCC-MNCs is 310-410. You can use the mcc and mnc parameters to search for the Network resource which represents AT&T US.
Example 3
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
