Skip to main content

Public IPs

| API | Portal |


API

With Telnyx Wireless you can map public static IPs to Telnyx SIMs with a few requests to the Telnyx API.

An internet protocol (IP) address is an identifier that is assigned to a specific device connected to a network that uses IP for communication. In short, IP addresses are used to identify and locate devices so that they can communicate with one another. There are four types of IP addresses:

  1. Public IP address - A globally unique address that is given to a device, which allows them to be advertised to the public internet.
  2. Private IP address - Not globally unique, and can be shared by several devices within a single local network, which is not directly accessible from the internet. For example, if I have 4 computers in my house, each one could have a private IP address and can connect to each other, but not to networks outside of it.
  3. Dynamic IP address - A temporary address associated with a device, which changes each time it connects to the web. Dynamic IP addresses are active for a specific period of time, then they expire.
  4. Static IP address - An IP address that is associated with a device and which cannot be changed.

Private IP vs Public Static IP for SIMs

When you buy a Telnyx SIM, it is associated with a dynamic private IP address by default. While private IPs can make requests to the internet, they cannot be reached from other places on the internet -- this means that you can connect from your SIM but not to your SIM, which limits your usability. If you would like to be able to connect to your SIM, and not just from your SIM, you will need a public static IP address. Public static IPs give the SIMs an address on the public internet so they can be reached from anywhere else that has internet access.

public ip

With this public IP feature, you can purchase a public static IP address for your SIMs. Specifically, in the API you can:

  1. upgrade SIM cards to using a public static IP for $3 per month.
  2. delete public IP addresses on SIMs.

1. Add Public IP to SIM Cards

Public static IPs can be added to SIM cards via the API simply by creating a public_ip resource on your sim_card resource. This will provision a public IP to the SIM card and set up a $3 monthly recurring charge on your account. A public_ip resource can be created using the below cURL request:

curl -X POST \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Authorization: Bearer YOUR_API_KEY" \
--data '{}' \
https://api.telnyx.com/v2/sim_cards/SIM_CARD_ID/public_ip

Note: After pasting the above content, Kindly check and remove any new line added

2. Delete Public IPs

In the same way that a public IP can be added by creating a public_ip resource, the public_ip resource can be viewed on a per SIM card basis via the below cURL request:

curl -X GET \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Authorization: Bearer YOUR_API_KEY" \
--globoff "https://api.telnyx.com/v2/sim_cards/SIM_CARD_ID/public_ip"

Note: After pasting the above content, Kindly check and remove any new line added

And the resource can be deleted via the below cURL request:

curl -X DELETE \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Authorization: Bearer YOUR_API_KEY" \
"https://api.telnyx.com/v2/sim_cards/SIM_CARD_ID/public_ip"

Note: After pasting the above content, Kindly check and remove any new line added

The API Reference for public IPs can be viewed in more detail here .

Portal

With Telnyx Wireless you can map public static IPs to Telnyx SIMs with a few simple clicks via the Mission Control Portal.

An internet protocol (IP) address is an identifier that is assigned to a specific device connected to a network that uses IP for communication. In short, IP addresses are used to identify and locate devices so that they can communicate with one another. There are four types of IP addresses:

  1. Public IP address - A globally unique address that is given to a device, which allows them to be advertised to the public internet.
  2. Private IP address - Not globally unique, and can be shared by several devices within a single local network, which is not directly accessible from the internet. For example, if I have 4 computers in my house, each one could have a private IP address and can connect to each other, but not to networks outside of it.
  3. Dynamic IP address - A temporary address associated with a device, which changes each time it connects to the web. Dynamic IP addresses are active for a specific period of time, then they expire.
  4. Static IP address - An IP address that is associated with a device and which cannot be changed.

Understanding Private IP vs Public Static IP for SIMs

When you buy a Telnyx SIM, it is associated with a dynamic private IP address by default. While private IPs can make requests to the internet, they cannot be reached from other places on the internet -- this means that you can connect from your SIM but not to your SIM, which limits your usability. If you would like to be able to connect to your SIM, and not just from your SIM, you will need a public static IP address. Public static IPs give the SIMs an address on the public internet so they can be reached from anywhere else that has internet access.

public ip

With this public IP feature, you can purchase a public static IP address for your SIMs. Specifically, in the Mission Control Portal you can:

  1. upgrade SIM cards to using a public static IP for $3 per month.
  2. delete public IP addresses on SIMs.
  3. view public IP address costs in your invoice.

1. Add Public IP to SIM Cards

Public static IPs can be added to SIM cards in the Portal simply by clicking into the SIM card and clicking the "Add a Public IP" button. This will provision a public IP to the SIM card and set up a $3 monthly recurring charge on your account.

Add public IP

2. Delete Public IPs

In the same way that a public IP can be added via the SIM card drilldown view, public IPs can be deleted by clicking on the "Delete Public IP" button.

View public IP

3. View Public IP Charges

Public IP charges can be viewed in your invoice under the WIRELESS - SIM CARDS SUMMARY section.

On this page