Menu

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

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
sid<HW> Not PII

The unique string that we created to identify the Network resource.

friendly_name
string Not PII

A human readable identifier of this resource.

url
url Not PII

The absolute URL of the Network resource.

iso_country
string Not PII

The ISO country code of the Network resource.

identifiers
object[] Not PII

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, ie. 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

get
https://supersim.twilio.com/v1/Networks/{Sid}
Parameters
Parameters in REST API format
sid
Path
get sid<HW> Not PII

The SID of the Network resource to fetch.

Example 1
        
        
        
        

        Read multiple Network resources

        get
        https://supersim.twilio.com/v1/Networks
        Parameters
        Parameters in REST API format
        iso_country
        Optional
        get string Not PII

        The ISO country code of the Network resources to read.

        mcc
        Optional
        get string Not PII

        The 'mobile country code' of a country. Network resources with this mcc in their identifiers will be read.

        mnc
        Optional
        get string Not PII

        The 'mobile network code' of a mobile operator network. Network resources with this mnc in their identifiers will be read.

        Example 1
              
              
              
              
              Example 2
                    
                    
                    
                    
                    Filter the list of Network resources by ISO country code

                    Read Network Resources in a Country

                    Filter the list of Network resources by ISO country code

                    You can use the a cellular network's MCC-MNC to search for a specific network. For example, one of AT&T US's MCC-MNCs is 310-410. You can use the mcc and mnc parameters to search for the Network resource that represents AT&T US.

                    Example 3
                          
                          
                          
                          
                          Filter the list of Network resources by MCC and MNC identifiers

                          Read Network resource by MCC-MNC

                          Filter the list of Network resources by MCC and MNC identifiers
                          Rate this page:

                          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.