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

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
const network = await client.supersim.v1
_14
.networkAccessProfiles("NetworkAccessProfileSid")
_14
.networks.create({ network: "HWd85b0262d6fc4c0b991bf8294596642e" });
_14
_14
console.log(network.sid);

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

_15
// Download the helper library from https://www.twilio.com/docs/node/install
_15
import twilio from "twilio";
_15
_15
// Find your Account SID and Auth Token at twilio.com/console
_15
// and set the environment variables. See http://twil.io/secure
_15
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_15
const authToken = process.env.TWILIO_AUTH_TOKEN;
_15
const client = twilio(accountSid, authToken);
_15
_15
const network = await client.supersim.v1
_15
.networkAccessProfiles("NetworkAccessProfileSid")
_15
.networks("HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
_15
.fetch();
_15
_15
console.log(network.sid);

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

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

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

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


Rate this page: