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 browsing the Twilio tag on Stack Overflow.