Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

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:


_10
https://supersim.twilio.com/v1/Networks

(information)

Info

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

network-properties page anchor
Resource properties
sidtype: SID<HW>Not PII

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


friendly_nametype: stringNot PII

A human readable identifier of this resource.


urltype: string<URI>Not PII

The absolute URL of the Network resource.


identifierstype: arrayNot PII

Array of objects identifying the MCC-MNCs(link takes you to an external page) that are included in the Network resource.


The identifiers property

the-identifiers-property page anchor

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.

mccThe Mobile Country Code (MCC) is the unique ID that identifies the mobile operator network's home country.
mncThe Mobile Network Code (MNC) is the unique ID that identifies the mobile operator network.
(information)

Info

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

fetch-a-network-resource page anchor
GET https://supersim.twilio.com/v1/Networks/{Sid}

Parameters

fetch-parameters page anchor
URI parameters
Sidtype: SID<HW>Not PII
Path Parameter

The SID of the Network resource to fetch.

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.supersim.v1.networks('HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa')
_10
.fetch()
_10
.then(network => console.log(network.friendlyName));

Output

_12
{
_12
"friendly_name": "AT&T",
_12
"iso_country": "US",
_12
"identifiers": [
_12
{
_12
"mcc": "310",
_12
"mnc": "410"
_12
}
_12
],
_12
"sid": "HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_12
"url": "https://supersim.twilio.com/v1/Networks/HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_12
}


Read multiple Network resources

read-multiple-network-resources page anchor
GET https://supersim.twilio.com/v1/Networks

URI parameters
IsoCountrytype: stringNot PII
Query Parameter

The ISO country code(link takes you to an external page) of the Network resources to read.


Mcctype: stringNot PII
Query Parameter

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


Mnctype: stringNot PII
Query Parameter

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


PageSizetype: integerNot PII
Query Parameter

How many resources to return in each list page. The default is 50, and the maximum is 1000.


Pagetype: integerNot PII
Query Parameter

The page index. This value is simply for client state.


PageTokentype: stringNot PII
Query Parameter

The page token. This is provided by the API.

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.supersim.v1.networks
_10
.list({limit: 20})
_10
.then(networks => networks.forEach(n => console.log(n.sid)));

Output

_25
{
_25
"meta": {
_25
"first_page_url": "https://supersim.twilio.com/v1/Networks?PageSize=50&Page=0",
_25
"key": "networks",
_25
"next_page_url": "https://supersim.twilio.com/v1/Networks?PageSize=50&Page=1",
_25
"page": 0,
_25
"page_size": 50,
_25
"previous_page_url": "https://supersim.twilio.com/v1/Networks?PageSize=50&Page=0",
_25
"url": "https://supersim.twilio.com/v1/Networks?PageSize=50&Page=0"
_25
},
_25
"networks": [
_25
{
_25
"friendly_name": "AT&T",
_25
"iso_country": "US",
_25
"identifiers": [
_25
{
_25
"mcc": "310",
_25
"mnc": "410"
_25
}
_25
],
_25
"sid": "HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_25
"url": "https://supersim.twilio.com/v1/Networks/HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_25
}
_25
]
_25
}

Read Network resources in a country

read-network-resources-in-a-country page anchor

Filter the list of Network resources by ISO country code.

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.supersim.v1.networks
_10
.list({isoCountry: 'US', limit: 20})
_10
.then(networks => networks.forEach(n => console.log(n.isoCountry)));

Output

_25
{
_25
"meta": {
_25
"first_page_url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=0",
_25
"key": "networks",
_25
"next_page_url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=1",
_25
"page": 0,
_25
"page_size": 50,
_25
"previous_page_url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=0",
_25
"url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=0"
_25
},
_25
"networks": [
_25
{
_25
"friendly_name": "AT&T",
_25
"iso_country": "US",
_25
"identifiers": [
_25
{
_25
"mcc": "310",
_25
"mnc": "410"
_25
}
_25
],
_25
"sid": "HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_25
"url": "https://supersim.twilio.com/v1/Networks/HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_25
}
_25
]
_25
}

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.

Read Network resource by MCC-MNC

read-network-resource-by-mcc-mnc page anchor

Filter the list of Network resources by MCC and MNC identifiers.

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.supersim.v1.networks
_10
.list({mcc: '310', mnc: '410', limit: 20})
_10
.then(networks => networks.forEach(n => console.log(n.identifiers)));

Output

_25
{
_25
"meta": {
_25
"first_page_url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=0",
_25
"key": "networks",
_25
"next_page_url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=1",
_25
"page": 0,
_25
"page_size": 50,
_25
"previous_page_url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=0",
_25
"url": "https://supersim.twilio.com/v1/Networks?IsoCountry=US&Mnc=410&Mcc=310&PageSize=50&Page=0"
_25
},
_25
"networks": [
_25
{
_25
"friendly_name": "AT&T",
_25
"iso_country": "US",
_25
"identifiers": [
_25
{
_25
"mcc": "310",
_25
"mnc": "410"
_25
}
_25
],
_25
"sid": "HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_25
"url": "https://supersim.twilio.com/v1/Networks/HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_25
}
_25
]
_25
}


Rate this page: