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:


_10https://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

Property nameTypePIIDescription

sidSID<HW>

Not PII

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

Pattern: ^HW[0-9a-fA-F]{32}$Min length: 34Max length: 34

friendly_namestring

Not PII

A human readable identifier of this resource.

urlstring<uri>

Not PII

The absolute URL of the Network resource.

iso_countrystring

Not PII

The ISO country code of the Network resource.

identifiersarray

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.

(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

GET https://supersim.twilio.com/v1/Networks/{Sid}

Path parameters

Property nameTypeRequiredPIIDescription

SidSID<HW>required

Not PII

The SID of the Network resource to fetch.

Pattern: ^HW[0-9a-fA-F]{32}$Min length: 34Max length: 34

Fetch a Network resource

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_18// Download the helper library from https://www.twilio.com/docs/node/install
_18const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18
_18// Find your Account SID and Auth Token at twilio.com/console
_18// and set the environment variables. See http://twil.io/secure
_18const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18const authToken = process.env.TWILIO_AUTH_TOKEN;
_18const client = twilio(accountSid, authToken);
_18
_18async function fetchNetwork() {
_18  const network = await client.supersim.v1
_18    .networks("HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_18    .fetch();
_18
_18  console.log(network.sid);
_18}
_18
_18fetchNetwork();

Output


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

Read multiple Network resources

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

Query parameters

Property nameTypeRequiredPIIDescription

IsoCountrystringOptional

Not PII

The ISO country code of the Network resources to read.

MccstringOptional

Not PII

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

MncstringOptional

Not PII

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

PageSizeintegerOptional

Not PII

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

Minimum: 1Maximum: 1000

PageintegerOptional

Not PII

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

Minimum: 0

PageTokenstringOptional

Not PII

The page token. This is provided by the API.

Read Network resources

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_16// Download the helper library from https://www.twilio.com/docs/node/install
_16const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_16
_16// Find your Account SID and Auth Token at twilio.com/console
_16// and set the environment variables. See http://twil.io/secure
_16const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16const authToken = process.env.TWILIO_AUTH_TOKEN;
_16const client = twilio(accountSid, authToken);
_16
_16async function listNetwork() {
_16  const networks = await client.supersim.v1.networks.list({ limit: 20 });
_16
_16  networks.forEach((n) => console.log(n.sid));
_16}
_16
_16listNetwork();

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": null,
_25    "page": 0,
_25    "page_size": 50,
_25    "previous_page_url": null,
_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": "HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_25      "url": "https://supersim.twilio.com/v1/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_25    }
_25  ]
_25}

Read Network resources in a country

Filter the list of Network resources by ISO country code.

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


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

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": null,
_25    "page": 0,
_25    "page_size": 50,
_25    "previous_page_url": null,
_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": "HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_25      "url": "https://supersim.twilio.com/v1/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_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

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

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


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

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": null,
_25    "page": 0,
_25    "page_size": 50,
_25    "previous_page_url": null,
_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": "HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_25      "url": "https://supersim.twilio.com/v1/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_25    }
_25  ]
_25}