Coverage - Telnyx

Networking resources are not available at every Telnyx location. GET /v2/network_coverage lists each location and the resources that can be created there.

Locations

Each result has a location object:

Field	Value
`region`	`AMER`, `EMEA`, or `APAC`
`site`	An area within the region, for example `ORD` in `AMER`
`pop`	A data center within the site, for example `CH1` in `ORD`
`name`	A readable name, for example `Chicago IL, US`
`code`	The location’s ID, for example `chicago-il`

A WireGuard Interface takes the location’s code as its region_code. available_services lists the resources that can be created at the location. Values include virtual_cross_connect, cloud_vpn (WireGuard Interface), tailscale_subnet_router, and private_wireless_gateway.

Query coverage

Filter by resource:

GET /v2/network_coverage?filter[available_services][contains]=cloud_vpn

Filter by resource and region:

GET /v2/network_coverage?filter[available_services][contains]=cloud_vpn&filter[location.region]=AMER

Filter by region:

GET /v2/network_coverage?filter[location.region]=EMEA

The second query returns the two AMER locations that offer WireGuard Interfaces:

{
  "data": [
    {
      "available_services": [
        "private_wireless_gateway",
        "virtual_cross_connect",
        "cloud_vpn",
        "ng_private_wireless_gateway"
      ],
      "location": {
        "region": "AMER",
        "site": "IAD",
        "pop": "DC2",
        "name": "Ashburn VA, US",
        "code": "ashburn-va"
      },
      "record_type": "network_coverage"
    },
    {
      "available_services": [
        "virtual_cross_connect",
        "cloud_vpn"
      ],
      "location": {
        "region": "AMER",
        "site": "ORD",
        "pop": "CH1",
        "name": "Chicago IL, US",
        "code": "chicago-il"
      },
      "record_type": "network_coverage"
    }
  ],
  "meta": {
    "total_pages": 1,
    "total_results": 2,
    "page_number": 1,
    "page_size": 25
  }
}

Virtual Cross Connect coverage

A Virtual Cross Connect has two ends: a Telnyx PoP and a cloud provider region. GET /v2/network_coverage covers only the Telnyx end. GET /v2/network_agents_gateway/vxc/coverage lists the pairs a Virtual Cross Connect can join, with the bandwidths available for each. List the cloud provider regions that a Virtual Cross Connect from the Telnyx CH1 PoP can reach:

GET /v2/network_agents_gateway/vxc/coverage?filter[location.pop]=CH1

List the Telnyx PoPs that a Virtual Cross Connect to AWS can use:

GET /v2/network_agents_gateway/vxc/coverage?filter[cloud_provider]=aws

The first query returns:

{
  "meta": {
    "page_size": 50,
    "page_number": 1,
    "total_pages": 1,
    "total_results": 3
  },
  "data": [
    {
      "cloud_provider": "aws",
      "cloud_provider_region": "us-east-2",
      "location": {
        "region": "AMER",
        "site": "ORD",
        "pop": "CH1",
        "name": "Chicago IL, US",
        "code": "chicago-il"
      },
      "available_bandwidth": [50, 100, 200, 500, 1000]
    },
    {
      "cloud_provider": "gcp",
      "cloud_provider_region": "us-central1",
      "location": {
        "region": "AMER",
        "site": "ORD",
        "pop": "CH1",
        "name": "Chicago IL, US",
        "code": "chicago-il"
      },
      "available_bandwidth": [50, 100, 200, 500, 1000]
    },
    {
      "cloud_provider": "azu",
      "cloud_provider_region": "northcentralus",
      "location": {
        "region": "AMER",
        "site": "ORD",
        "pop": "CH1",
        "name": "Chicago IL, US",
        "code": "chicago-il"
      },
      "available_bandwidth": [50, 100, 200, 500, 1000]
    }
  ]
}

available_bandwidth is in Mbps.

​Locations

​Query coverage

​Virtual Cross Connect coverage

Locations

Query coverage

Virtual Cross Connect coverage