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

NetworkAccessProfile Networks Subresource


Each Network Access Profile resource has a Networks subresource (NAP Networks ) that contains a list of allowed cellular networks to Super SIMs can connect.


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

The NAP Network resources in this subresource are a subset of all of the Network resources available from the Networks resource. You can add or remove NAP Network resources from the NAP Networks subresource at any time to change which cellular networks Super SIMs using the parent Network Access Profile resource can connect to.

The Sid used to add, remove, or identify NAP Network resources is the same as the Sid of the corresponding Network resource. You can filter the NAP Networks subresource the same way you can the Networks resource.


NetworkAccessProfile Network properties

networkaccessprofile-network-properties page anchor

A Network Access Profile Network resource (NAP Network) has the same representation and values as the corresponding available Network resource with the exception of the additional NetworkAccessProfileSid property that identifies the Network Access Profile the subresource belongs to.

Property nameTypePIIDescription
sidSID<HW>
Not PII

The unique string that identifies the Network resource.

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

network_access_profile_sidSID<HA>

The unique string that identifies the Network resource's Network Access Profile resource.

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

friendly_namestring

A human readable identifier of the Network this resource refers to.


identifiersarray

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


urlstring<uri>

The absolute URL of the Network resource.


Create a NetworkAccessProfile Network resource

create-a-networkaccessprofile-network-resource page anchor
POST https://supersim.twilio.com/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks

To allow Super SIMs to connect to a cellular network represented by a Network resource, a NAP Network resource must be created. Use the sid of the Network resource you with to add in your create request to add the NAP Networks subresource.

For example, if you wish to allow Super SIMs to connect to AT&T US.

First, you need to know the sid of the Network resource that represents AT&T US. You could do that by reading through the list of Network resources or if you know the MCC and MNC identifiers, you can read Networks resource by MCC and MNC. You will find that the Sid of the Network resource representing AT&T US is HWd85b0262d6fc4c0b991bf8294596642e.

Now that you know the Sid of the Network resource you wish to add, pass in HWd85b0262d6fc4c0b991bf8294596642e into your create NAP Network resource request.

Path parameters

path-parameters page anchor
Property nameTypeRequiredPIIDescription
NetworkAccessProfileSidstringrequired

The unique string that identifies the Network Access Profile resource.

Property nameTypeRequiredPIIDescription
NetworkSID<HW>required

The SID of the Network resource to be added to the Network Access Profile resource.

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

Create a NAP Network resource

create-a-nap-network-resource page anchor

Use the sid of desired resource from the Networks resource

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

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
const 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
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
async function createNetworkAccessProfileNetwork() {
_18
const network = await client.supersim.v1
_18
.networkAccessProfiles("NetworkAccessProfileSid")
_18
.networks.create({ network: "HWd85b0262d6fc4c0b991bf8294596642e" });
_18
_18
console.log(network.sid);
_18
}
_18
_18
createNetworkAccessProfileNetwork();

Output

_13
{
_13
"sid": "HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_13
"network_access_profile_sid": "NetworkAccessProfileSid",
_13
"friendly_name": "AT&T",
_13
"iso_country": "us",
_13
"identifiers": [
_13
{
_13
"mcc": "310",
_13
"mnc": "410"
_13
}
_13
],
_13
"url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_13
}


Fetch a NetworkAccessProfile Network resource

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

Property nameTypeRequiredPIIDescription
NetworkAccessProfileSidstringrequired

The unique string that identifies the Network Access Profile resource.


SidSID<HW>required

The SID of the Network resource to fetch.

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

Fetch a NAP Network resource

fetch-a-nap-network-resource page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_19
// Download the helper library from https://www.twilio.com/docs/node/install
_19
const 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
_19
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_19
const authToken = process.env.TWILIO_AUTH_TOKEN;
_19
const client = twilio(accountSid, authToken);
_19
_19
async function fetchNetworkAccessProfileNetwork() {
_19
const network = await client.supersim.v1
_19
.networkAccessProfiles("NetworkAccessProfileSid")
_19
.networks("HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
_19
.fetch();
_19
_19
console.log(network.sid);
_19
}
_19
_19
fetchNetworkAccessProfileNetwork();

Output

_13
{
_13
"sid": "HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_13
"network_access_profile_sid": "NetworkAccessProfileSid",
_13
"friendly_name": "AT&T",
_13
"iso_country": "us",
_13
"identifiers": [
_13
{
_13
"mcc": "310",
_13
"mnc": "410"
_13
}
_13
],
_13
"url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_13
}


Read multiple NetworkAccessProfile Network resources

read-multiple-networkaccessprofile-network-resources page anchor
GET https://supersim.twilio.com/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks

Property nameTypeRequiredPIIDescription
NetworkAccessProfileSidstringrequired

The unique string that identifies the Network Access Profile resource.

Property nameTypeRequiredPIIDescription
PageSizeintegerOptional

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

Minimum: 1Maximum: 1000

PageintegerOptional

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

Minimum: 0

PageTokenstringOptional

The page token. This is provided by the API.

Read multiple NAP Network resources

read-multiple-nap-network-resources page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
const 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
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
async function listNetworkAccessProfileNetwork() {
_18
const networks = await client.supersim.v1
_18
.networkAccessProfiles("NetworkAccessProfileSid")
_18
.networks.list({ limit: 20 });
_18
_18
networks.forEach((n) => console.log(n.sid));
_18
}
_18
_18
listNetworkAccessProfileNetwork();

Output

_26
{
_26
"meta": {
_26
"first_page_url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks?PageSize=50&Page=0",
_26
"key": "networks",
_26
"next_page_url": null,
_26
"page": 0,
_26
"page_size": 50,
_26
"previous_page_url": null,
_26
"url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks?PageSize=50&Page=0"
_26
},
_26
"networks": [
_26
{
_26
"sid": "HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_26
"network_access_profile_sid": "HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_26
"friendly_name": "AT&T",
_26
"iso_country": "us",
_26
"identifiers": [
_26
{
_26
"mcc": "310",
_26
"mnc": "410"
_26
}
_26
],
_26
"url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_26
}
_26
]
_26
}


Delete a NetworkAccessProfile Network resource

delete-a-networkaccessprofile-network-resource page anchor
DELETE https://supersim.twilio.com/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks/{Sid}

Property nameTypeRequiredPIIDescription
NetworkAccessProfileSidSID<HA>required

The unique string that identifies the Network Access Profile resource.

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

SidSID<HW>required

The SID of the Network resource to be removed from the Network Access Profile resource.

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

Delete a NAP Network resource

delete-a-nap-network-resource page anchor

Disable a cellular network by deleting the NAP Network resource

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

_17
// Download the helper library from https://www.twilio.com/docs/node/install
_17
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_17
_17
// Find your Account SID and Auth Token at twilio.com/console
_17
// and set the environment variables. See http://twil.io/secure
_17
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_17
const authToken = process.env.TWILIO_AUTH_TOKEN;
_17
const client = twilio(accountSid, authToken);
_17
_17
async function deleteNetworkAccessProfileNetwork() {
_17
await client.supersim.v1
_17
.networkAccessProfiles("HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_17
.networks("HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
_17
.remove();
_17
}
_17
_17
deleteNetworkAccessProfileNetwork();


Rate this page: