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.
_10https://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.
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
The unique string that identifies the Network resource.
Pattern: ^HW[0-9a-fA-F]{32}$
Min length: 34
Max 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: 34
Max length: 34
A human readable identifier of the Network this resource refers to.
The absolute URL of the Network resource.
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.
Property nameTypeRequiredPIIDescription
NetworkAccessProfileSidstringrequired The unique string that identifies the Network Access Profile resource.
Property nameTypeRequiredPIIDescription
The SID of the Network resource to be added to the Network Access Profile resource.
Pattern: ^HW[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
Use the sid of desired resource from the Networks resource
_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// 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);
_18async function createNetworkAccessProfileNetwork() {
_18 const network = await client.supersim.v1
_18 .networkAccessProfiles("NetworkAccessProfileSid")
_18 .networks.create({ network: "HWd85b0262d6fc4c0b991bf8294596642e" });
_18 console.log(network.sid);
_18createNetworkAccessProfileNetwork();
_13 "sid": "HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_13 "network_access_profile_sid": "NetworkAccessProfileSid",
_13 "friendly_name": "AT&T",
_13 "url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
GET https://supersim.twilio.com/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks/{Sid}
Property nameTypeRequiredPIIDescription
NetworkAccessProfileSidstringrequired The unique string that identifies the Network Access Profile resource.
The SID of the Network resource to fetch.
Pattern: ^HW[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
_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// 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);
_19async function fetchNetworkAccessProfileNetwork() {
_19 const network = await client.supersim.v1
_19 .networkAccessProfiles("NetworkAccessProfileSid")
_19 .networks("HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
_19 console.log(network.sid);
_19fetchNetworkAccessProfileNetwork();
_13 "sid": "HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_13 "network_access_profile_sid": "NetworkAccessProfileSid",
_13 "friendly_name": "AT&T",
_13 "url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
GET https://supersim.twilio.com/v1/NetworkAccessProfiles/{NetworkAccessProfileSid}/Networks
Property nameTypeRequiredPIIDescription
NetworkAccessProfileSidstringrequired The unique string that identifies the Network Access Profile resource.
Property nameTypeRequiredPIIDescription
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum: 1
Maximum: 1000
The page index. This value is simply for client state.
Minimum: 0
The page token. This is provided by the API.
_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// 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);
_18async function listNetworkAccessProfileNetwork() {
_18 const networks = await client.supersim.v1
_18 .networkAccessProfiles("NetworkAccessProfileSid")
_18 .networks.list({ limit: 20 });
_18 networks.forEach((n) => console.log(n.sid));
_18listNetworkAccessProfileNetwork();
_26 "first_page_url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks?PageSize=50&Page=0",
_26 "next_page_url": null,
_26 "previous_page_url": null,
_26 "url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks?PageSize=50&Page=0"
_26 "sid": "HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_26 "network_access_profile_sid": "HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_26 "friendly_name": "AT&T",
_26 "url": "https://supersim.twilio.com/v1/NetworkAccessProfiles/HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Networks/HWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
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: 34
Max length: 34
The SID of the Network resource to be removed from the Network Access Profile resource.
Pattern: ^HW[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
Disable a cellular network by deleting the NAP Network resource
_17// Download the helper library from https://www.twilio.com/docs/node/install
_17const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_17// Find your Account SID and Auth Token at twilio.com/console
_17// and set the environment variables. See http://twil.io/secure
_17const accountSid = process.env.TWILIO_ACCOUNT_SID;
_17const authToken = process.env.TWILIO_AUTH_TOKEN;
_17const client = twilio(accountSid, authToken);
_17async function deleteNetworkAccessProfileNetwork() {
_17 await client.supersim.v1
_17 .networkAccessProfiles("HAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_17 .networks("HWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
_17deleteNetworkAccessProfileNetwork();