Access Tokens1

Addresses6

Advanced Number Orders4

Assistants46

Audio1

Audit Logs1

Authentication Providers5

AutoRechargePreferences2

Billing1

Billing Groups5

Brands15

Bucket SSL Certificate3

Bucket Usage2

Bulk Phone Number Campaigns3

Bulk Phone Number Operations5

Bundles2

Call Commands41

Call Control Applications5

Call Information2

Call Recordings11

Campaign13

CDR Reports5

CDR Usage Reports5

Chat4

Clusters5

Comments2

Conference Commands23

Connections2

Conversation Histories1

Conversations20

Country Coverage2

Coverage1

Credential Connections6

Credentials5

CSV Downloads3

Customer Service Record4

Data Migration9

Debugging1

Detail Records1

Dialogflow Integration4

Display Identity Records8

Documents9

Dynamic Emergency Addresses4

Dynamic Emergency Endpoints4

Embeddings8

Enterprises6

Enum1

External Connections23

Fine Tuning4

FQDN Connections5

FQDNs5

Global IPs20

Hosted Numbers9

Inexplicit Number Orders3

Infringement Claims4

Integration Secrets3

Integrations5

Inventory Level1

IP Addresses4

IP Connections5

IP Ranges3

IPs5

Managed Accounts8

MCP Servers5

MDR Detail Reports1

MDR Detailed Reports4

MDR Usage Reports9

Media Storage API6

Messages10

Messaging11

Messaging URL Domains1

Missions41

Mobile Network Operators1

Mobile Number Settings2

Mobile Phone Numbers3

Mobile Voice Connections5

Networks9

Notifications16

Number Lookup1

Number Portout14

Number Settings5

numbers features1

OAuth Clients5

OAuth Discovery2

OAuth Grants3

OAuth Protocol7

OpenAI Chat3

OpenAI Embeddings2

Opt-Out Management6

Organization Users4

OTA updates2

Outbound Voice Profiles5

Phone Number Batches2

Phone Number Block Orders3

Phone Number Blocks Background Jobs3

Phone Number Campaigns5

Phone Number Configurations11

Phone Number Orders18

Phone Number Porting1

Phone Number Reservations4

Phone Number Search2

Phone Numbers3

Porting Orders53

Presigned Object URLs1

Private Wireless Gateways4

Profiles7

Programmable Fax Applications5

Programmable Fax Commands6

Pronunciation Dictionaries5

Public Internet Gateways4

Push Credentials4

Queue Commands9

RCS8

Reference Data3

Regions1

Regulatory Requirements2

Reporting4

Reports2

Reputation17

Requirement Groups8

Requirement Types2

Requirements2

Room Compositions4

Room Participants2

Room Recordings4

Room Sessions7

Rooms6

Rooms Client Tokens2

Session Analysis3

SETI Observability1

Shared Campaigns5

Short Codes3

SIM Card Actions4

SIM Card Group Actions2

SIM Card Groups9

SIM Card Orders4

SIM Cards24

SIPREC Connectors4

Speech to Text Batch Reports4

Speech To Text Capabilities1

Speech To Text over WebSockets1

Speech to text Usage Reports1

Stored Payment Transactions1

Telco Data Usage Reports4

Terms of Service6

TeXML Applications5

TeXML REST Commands34

Text To Speech Commands3

Traffic Policy Profiles6

UAC Connections7

Usage Reports (BETA)2

User Bundles6

User Tags1

UserAddresses3

Verification Requests6

Verified Numbers5

Verify16

Virtual Cross Connects6

Voice Channels6

Voice Clones6

Voice Designs7

Voice SDK Stats2

Voicemail3

WDR Detail Reports1

Webhooks2

Whatsapp Business Accounts8

Whatsapp Message Templates5

Whatsapp messaging1

Whatsapp Phone Numbers12

WireGuard Interfaces10

Wireless Blocklists6

Wireless Regions1

x402 Payment Transactions2

Webhooks

Callbacks66

Virtual Cross Connects

Retrieve a Virtual Cross Connect

Retrieve a Virtual Cross Connect.

get/virtual_cross_connects/{id}

Path parameters

idstring uuid required

Example:6a09cdc3-8948-47f0-aa62-74ac943d6c58

Identifies the resource.

Response

Successful response

Example response

{
  "data": {
    "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "record_type": "sample_record_type",
    "created_at": "2018-02-02T22:25:27.521Z",
    "updated_at": "2018-02-02T22:25:27.521Z",
    "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "name": "test interface",
    "status": "provisioned",
    "cloud_provider": "aws",
    "cloud_provider_region": "us-east-1",
    "bgp_asn": 1234,
    "bandwidth_mbps": 50,
    "primary_enabled": true,
    "primary_cloud_account_id": "123456789012",
    "primary_telnyx_ip": "169.254.0.1",
    "primary_cloud_ip": "169.254.0.2",
    "primary_bgp_key": "yFV4wEPtPVPfDUGLWiyQzwga",
    "secondary_enabled": true,
    "secondary_telnyx_ip": "169.254.0.3",
    "secondary_cloud_ip": "169.254.0.4",
    "secondary_bgp_key": "ge1lONeK9RcA83uuWaw9DvZy",
    "region_code": "ashburn-va",
    "region": {
      "code": "ashburn-va",
      "name": "Ashburn",
      "record_type": "region"
    }
  }
}

Changes

Changed in 4 of the 47 revisions of this API.43842

Jun 5, 20268a8c40f458c51191See the full diff
- ▲
  the data response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property data/bandwidth_mbps from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/bgp_asn from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/cloud_provider from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/cloud_provider_region from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/created_at from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/network_id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_bgp_key from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_cloud_account_id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_cloud_ip from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_enabled from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_routing_announcement from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_telnyx_ip from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/record_type from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/region from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/region_code from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/status from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/updated_at from the response with the 200 status
  response-optional-property-removed
- ○
  added VirtualCrossConnectCreate VirtualCrossConnectPatch RegionOut to the data response property allOf list for the response status 200
  response-property-all-of-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 14, 202650870cc05614120See the full diff
- ▲
  the data response's property type/format changed from / to object/ for status 200
  response-property-type-changed
- ○
  added the optional property data/bandwidth_mbps to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/bgp_asn to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/cloud_provider to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/cloud_provider_region to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/created_at to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/name to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/network_id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_bgp_key to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_cloud_account_id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_cloud_ip to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_enabled to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_routing_announcement to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_telnyx_ip to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/record_type to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/region to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/region_code to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/status to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/updated_at to the response with the 200 status
  response-optional-property-added
- ○
  removed VirtualCrossConnectCreate VirtualCrossConnectPatch RegionOut from the data response property allOf list for the response status 200
  response-property-all-of-removed
May 14, 2026a144ff96b4ac1191See the full diff
- ▲
  the data response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property data/bandwidth_mbps from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/bgp_asn from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/cloud_provider from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/cloud_provider_region from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/created_at from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/network_id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_bgp_key from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_cloud_account_id from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_cloud_ip from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_enabled from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_routing_announcement from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/primary_telnyx_ip from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/record_type from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/region from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/region_code from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/status from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/updated_at from the response with the 200 status
  response-optional-property-removed
- ○
  added VirtualCrossConnectCreate VirtualCrossConnectPatch RegionOut to the data response property allOf list for the response status 200
  response-property-all-of-added
May 8, 202630cb1ddce91b120See the full diff
- ▲
  the data response's property type/format changed from / to object/ for status 200
  response-property-type-changed
- ○
  added the optional property data/bandwidth_mbps to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/bgp_asn to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/cloud_provider to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/cloud_provider_region to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/created_at to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/name to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/network_id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_bgp_key to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_cloud_account_id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_cloud_ip to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_enabled to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_routing_announcement to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/primary_telnyx_ip to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/record_type to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/region to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/region_code to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/status to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/updated_at to the response with the 200 status
  response-optional-property-added
- ○
  removed VirtualCrossConnectCreate VirtualCrossConnectPatch RegionOut from the data response property allOf list for the response status 200
  response-property-all-of-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history