Telnyx

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: 'My API Key',
});

const fqdnConnections = await client.fqdnConnections.list();

console.log(fqdnConnections.data);

{
  "data": [
    {
      "id": "1293384261075731499",
      "record_type": "fqdn_connection",
      "active": true,
      "anchorsite_override": "Latency",
      "connection_name": "string",
      "transport_protocol": "UDP",
      "default_on_hold_comfort_noise_enabled": true,
      "dtmf_type": "RFC 2833",
      "encode_contact_header_enabled": true,
      "encrypted_media": "SRTP",
      "onnet_t38_passthrough_enabled": true,
      "ios_push_credential_id": "ec0c8e5d-439e-4620-a0c1-9d9c8d02a836",
      "android_push_credential_id": "06b09dfd-7154-4980-8b75-cebf7a9d4f8e",
      "webhook_event_url": "https://example.com",
      "webhook_event_failover_url": "https://failover.example.com",
      "webhook_api_version": "1",
      "webhook_timeout_secs": 25,
      "call_cost_in_webhooks": false,
      "tags": [
        "tag1",
        "tag2"
      ],
      "rtcp_settings": {
        "port": "rtcp-mux",
        "capture_enabled": true,
        "report_frequency_secs": 10
      },
      "created_at": "2018-02-02T22:25:27.521Z",
      "updated_at": "2018-02-02T22:25:27.521Z",
      "inbound": {
        "ani_number_format": "+E.164",
        "dnis_number_format": "+e164",
        "codecs": [
          "G722"
        ],
        "default_routing_method": "sequential",
        "channel_limit": 10,
        "generate_ringback_tone": true,
        "isup_headers_enabled": true,
        "prack_enabled": true,
        "sip_compact_headers_enabled": true,
        "sip_region": "US",
        "sip_subdomain": "string",
        "sip_subdomain_receive_settings": "only_my_connections",
        "timeout_1xx_secs": 10,
        "timeout_2xx_secs": 10,
        "shaken_stir_enabled": true
      },
      "outbound": {
        "ani_override": "string",
        "ani_override_type": "always",
        "call_parking_enabled": true,
        "channel_limit": 10,
        "generate_ringback_tone": true,
        "instant_ringback_enabled": true,
        "ip_authentication_method": "credential-authentication",
        "ip_authentication_token": "string",
        "localization": "string",
        "outbound_voice_profile_id": "1293384261075731499",
        "t38_reinvite_source": "customer",
        "tech_prefix": "string"
      }
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}

GET

fqdn_connections

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: 'My API Key',
});

const fqdnConnections = await client.fqdnConnections.list();

console.log(fqdnConnections.data);

{
  "data": [
    {
      "id": "1293384261075731499",
      "record_type": "fqdn_connection",
      "active": true,
      "anchorsite_override": "Latency",
      "connection_name": "string",
      "transport_protocol": "UDP",
      "default_on_hold_comfort_noise_enabled": true,
      "dtmf_type": "RFC 2833",
      "encode_contact_header_enabled": true,
      "encrypted_media": "SRTP",
      "onnet_t38_passthrough_enabled": true,
      "ios_push_credential_id": "ec0c8e5d-439e-4620-a0c1-9d9c8d02a836",
      "android_push_credential_id": "06b09dfd-7154-4980-8b75-cebf7a9d4f8e",
      "webhook_event_url": "https://example.com",
      "webhook_event_failover_url": "https://failover.example.com",
      "webhook_api_version": "1",
      "webhook_timeout_secs": 25,
      "call_cost_in_webhooks": false,
      "tags": [
        "tag1",
        "tag2"
      ],
      "rtcp_settings": {
        "port": "rtcp-mux",
        "capture_enabled": true,
        "report_frequency_secs": 10
      },
      "created_at": "2018-02-02T22:25:27.521Z",
      "updated_at": "2018-02-02T22:25:27.521Z",
      "inbound": {
        "ani_number_format": "+E.164",
        "dnis_number_format": "+e164",
        "codecs": [
          "G722"
        ],
        "default_routing_method": "sequential",
        "channel_limit": 10,
        "generate_ringback_tone": true,
        "isup_headers_enabled": true,
        "prack_enabled": true,
        "sip_compact_headers_enabled": true,
        "sip_region": "US",
        "sip_subdomain": "string",
        "sip_subdomain_receive_settings": "only_my_connections",
        "timeout_1xx_secs": 10,
        "timeout_2xx_secs": 10,
        "shaken_stir_enabled": true
      },
      "outbound": {
        "ani_override": "string",
        "ani_override_type": "always",
        "call_parking_enabled": true,
        "channel_limit": 10,
        "generate_ringback_tone": true,
        "instant_ringback_enabled": true,
        "ip_authentication_method": "credential-authentication",
        "ip_authentication_token": "string",
        "localization": "string",
        "outbound_voice_profile_id": "1293384261075731499",
        "t38_reinvite_source": "customer",
        "tech_prefix": "string"
      }
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

filter

object

Consolidated filter parameter (deepObject style). Originally: filter[connection_name], filter[fqdn], filter[outbound_voice_profile_id], filter[outbound.outbound_voice_profile_id]

Show child attributes

filter[connection_name]

object

Filter by connection_name using nested operations

Show child attributes

filter[connection_name][contains]

string

If present, connections with <code>connection_name</code> containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.

filter[fqdn]

string

If present, connections with an fqdn that equals the given value will be returned. Matching is case-sensitive, and the full string must match.

filter[outbound_voice_profile_id]

string<int64>

Identifies the associated outbound voice profile.

Example:

"1293384261075731499"

page

object

Consolidated page parameter (deepObject style). Originally: page[size], page[number]

Show child attributes

page[size]

integer

default:250

The size of the page

Required range: 1 <= x <= 250

page[number]

integer

default:1

The page number to load

Required range: x >= 1

sort

enum<string>

default:created_at

Specifies the sort order for results. By default sorting direction is ascending. To have the results sorted in descending order add the <code> -</code> prefix.<br/><br/> That is: <ul>

<li> <code>connection_name</code>: sorts the result by the <code>connection_name</code> field in ascending order. </li> <li> <code>-connection_name</code>: sorts the result by the <code>connection_name</code> field in descending order. </li> </ul> <br/> If not given, results are sorted by <code>created_at</code> in descending order.

Available options:

created_at,

connection_name,

active

Example:

"connection_name"

Response

Successful response with a list of FQDN connections.

data

FQDN Connection · object[]

Show child attributes

data.connection_name

string

required

A user-assigned name to help manage the connection.

Example:

"office-connection"

data.id

string<int64>

Identifies the resource.

Example:

"1293384261075731499"

data.record_type

string

Identifies the type of the resource.

Example:

"fqdn_connection"

data.active

boolean

Defaults to true

data.anchorsite_override

enum<string>

default:Latency

Latency directs Telnyx to route media through the site with the lowest round-trip time to the user's connection. Telnyx calculates this time using ICMP ping messages. This can be disabled by specifying a site to handle all media.

Available options:

Latency,

Chicago, IL,

Ashburn, VA,

San Jose, CA,

Sydney, Australia,

Amsterdam, Netherlands,

London, UK,

Toronto, Canada,

Vancouver, Canada,

Frankfurt, Germany

Example:

"Amsterdam, Netherlands"

data.transport_protocol

enum<string>

default:UDP

One of UDP, TLS, or TCP. Applies only to connections with IP authentication or FQDN authentication.

Available options:

UDP,

TCP,

TLS

data.default_on_hold_comfort_noise_enabled

boolean

default:true

When enabled, Telnyx will generate comfort noise when you place the call on hold. If disabled, you will need to generate comfort noise or on hold music to avoid RTP timeout.

data.dtmf_type

enum<string>

default:RFC 2833

Sets the type of DTMF digits sent from Telnyx to this Connection. Note that DTMF digits sent to Telnyx will be accepted in all formats.

Available options:

RFC 2833,

Inband,

SIP INFO

Example:

"Inband"

data.encode_contact_header_enabled

boolean

default:false

Encode the SIP contact header sent by Telnyx to avoid issues for NAT or ALG scenarios.

data.encrypted_media

enum<string> | null

Enable use of SRTP for encryption. Cannot be set if the transport_portocol is TLS.

Available options:

SRTP,

Example:

"SRTP"

data.microsoft_teams_sbc

boolean

default:false

The connection is enabled for Microsoft Teams Direct Routing.

data.onnet_t38_passthrough_enabled

boolean

default:false

Enable on-net T38 if you prefer that the sender and receiver negotiate T38 directly when both are on the Telnyx network. If this is disabled, Telnyx will be able to use T38 on just one leg of the call according to each leg's settings.

data.user_name

string

The username for the FQDN connection.

data.password

string

The password for the FQDN connection.

data.rtp_pass_codecs_on_stream_change

boolean

Defines if codecs should be passed on stream change.

data.adjust_dtmf_timestamp

boolean

Indicates whether DTMF timestamp adjustment is enabled.

data.ignore_dtmf_duration

boolean

Indicates whether DTMF duration should be ignored.

data.ignore_mark_bit

boolean

Indicates whether the mark bit should be ignored.

data.call_cost_enabled

boolean

Indicates whether call cost calculation is enabled.

data.noise_suppression

boolean

Indicates whether noise suppression is enabled.

data.send_normalized_timestamps

boolean

Indicates whether normalized timestamps should be sent.

data.third_party_control_enabled

boolean

Indicates whether third-party control is enabled.

data.txt_name

string

The name for the TXT record associated with the FQDN connection.

data.txt_value

string

The value for the TXT record associated with the FQDN connection.

data.txt_ttl

integer

The time to live for the TXT record associated with the FQDN connection.

data.tags

string[]

Tags associated with the connection.

Example:

["tag1", "tag2"]

data.call_cost_in_webhooks

boolean

default:false

Specifies if call cost webhooks should be sent for this connection.

data.webhook_event_url

string<uri>

The URL where webhooks related to this connection will be sent. Must include a scheme, such as 'https'.

Example:

"https://example.com"

data.webhook_event_failover_url

string<uri> | null

default:""

The failover URL where webhooks related to this connection will be sent if sending to the primary URL fails. Must include a scheme, such as 'https'.

Example:

"https://failover.example.com"

data.webhook_api_version

enum<string>

default:1

Determines which webhook format will be used, Telnyx API v1 or v2.

Available options:

1,

2

Example:

"1"

data.webhook_timeout_secs

integer | null

Specifies how many seconds to wait before timing out a webhook.

Required range: 0 <= x <= 30

Example:

25

data.rtcp_settings

Connection RTCP Settings · object

Show child attributes

data.rtcp_settings.port

enum<string>

default:rtp+1

RTCP port by default is rtp+1, it can also be set to rtcp-mux

Available options:

rtcp-mux,

rtp+1

data.rtcp_settings.capture_enabled

boolean

default:false

BETA - Enable the capture and storage of RTCP messages to create QoS reports on the Telnyx Mission Control Portal.

Example:

true

data.rtcp_settings.report_frequency_secs

integer

default:5

RTCP reports are sent to customers based on the frequency set. Frequency is in seconds and it can be set to values from 5 to 3000 seconds.

Example:

10

Example:

{
  "port": "rtcp-mux",
  "capture_enabled": true,
  "report_frequency_secs": 10
}

data.created_at

string

ISO 8601 formatted date indicating when the resource was created.

Example:

"2020-02-02T22:25:27.521Z"

data.updated_at

string

ISO 8601 formatted date indicating when the resource was updated.

Example:

"2020-02-03T22:25:27.521Z"

data.inbound

Inbound FQDN · object

Show child attributes

data.inbound.ani_number_format

enum<string>

default:E.164-national

This setting allows you to set the format with which the caller's number (ANI) is sent for inbound phone calls.

Available options:

+E.164,

E.164,

+E.164-national,

E.164-national

data.inbound.dnis_number_format

enum<string>

default:e164

Available options:

+e164,

e164,

national,

sip_username

data.inbound.codecs

string[]

Defines the list of codecs that Telnyx will send for inbound calls to a specific number on your portal account, in priority order. This only works when the Connection the number is assigned to uses Media Handling mode: default. OPUS and H.264 codecs are available only when using TCP or TLS transport for SIP.

data.inbound.default_routing_method

enum<string> | null

default:sequential

Default routing method to be used when a number is associated with the connection. Must be one of the routing method types or null, other values are not allowed.

Available options:

sequential,

round-robin,

data.inbound.default_primary_fqdn_id

string<int64> | null

The default primary FQDN to use for the number. Only settable if the connection is of FQDN type. Value must be the ID of an FQDN set on the connection.

data.inbound.default_secondary_fqdn_id

string<int64> | null

The default secondary FQDN to use for the number. Only settable if the connection is of FQDN type. Value must be the ID of an FQDN set on the connection.

data.inbound.default_tertiary_fqdn_id

string<int64> | null

The default tertiary FQDN to use for the number. Only settable if the connection is of FQDN type. Value must be the ID of an FQDN set on the connection.

data.inbound.channel_limit

integer | null

When set, this will limit the total number of inbound calls to phone numbers associated with this connection.

data.inbound.generate_ringback_tone

boolean

default:false

Generate ringback tone through 183 session progress message with early media.

data.inbound.isup_headers_enabled

boolean

default:false

When set, inbound phone calls will receive ISUP parameters via SIP headers. (Only when available and only when using TCP or TLS transport.)

data.inbound.prack_enabled

boolean

default:false

Enable PRACK messages as defined in RFC3262.

data.inbound.sip_compact_headers_enabled

boolean

default:true

Defaults to true.

data.inbound.sip_region

enum<string>

default:US

Selects which sip_region to receive inbound calls from. If null, the default region (US) will be used.

Available options:

US,

Europe,

Australia

data.inbound.sip_subdomain

string | null

Specifies a subdomain that can be used to receive Inbound calls to a Connection, in the same way a phone number is used, from a SIP endpoint. Example: the subdomain "example.sip.telnyx.com" can be called from any SIP endpoint by using the SIP URI "sip:@example.sip.telnyx.com" where the user part can be any alphanumeric value. Please note TLS encrypted calls are not allowed for subdomain calls.

data.inbound.sip_subdomain_receive_settings

enum<string>

default:from_anyone

This option can be enabled to receive calls from: "Anyone" (any SIP endpoint in the public Internet) or "Only my connections" (any connection assigned to the same Telnyx user).

Available options:

only_my_connections,

from_anyone

data.inbound.timeout_1xx_secs

integer

default:3

Time(sec) before aborting if connection is not made.

Required range: 1 <= x <= 120

data.inbound.timeout_2xx_secs

integer

default:90

Time(sec) before aborting if call is unanswered (min: 1, max: 600).

Required range: 1 <= x <= 600

data.inbound.shaken_stir_enabled

boolean

default:false

When enabled the SIP Connection will receive the Identity header with Shaken/Stir data in the SIP INVITE message of inbound calls, even when using UDP transport.

Example:

{
  "ani_number_format": "+E.164",
  "dnis_number_format": "+e164",
  "codecs": ["G722"],
  "default_routing_method": "sequential",
  "default_primary_fqdn_id": "1293384261075731497",
  "default_secondary_fqdn_id": "1293384261075731498",
  "default_tertiary_fqdn_id": "1293384261075731499",
  "channel_limit": 10,
  "generate_ringback_tone": true,
  "isup_headers_enabled": true,
  "prack_enabled": true,
  "sip_compact_headers_enabled": true,
  "sip_region": "US",
  "sip_subdomain": "test",
  "sip_subdomain_receive_settings": "only_my_connections",
  "timeout_1xx_secs": 10,
  "timeout_2xx_secs": 20,
  "shaken_stir_enabled": true
}

data.outbound

Connection Outbound Settings · object

Show child attributes

data.outbound.ani_override

string<E.164>

Set a phone number as the ani_override value to override caller id number on outbound calls.

data.outbound.ani_override_type

enum<string>

default:always

Specifies when we should apply your ani_override setting. Only applies when ani_override is not blank.

Available options:

always,

normal,

emergency

Example:

"normal"

data.outbound.call_parking_enabled

boolean | null

default:false

Forces all SIP calls originated on this connection to be "parked" instead of "bridged" to the destination specified on the URI. Parked calls will return ringback to the caller and will await for a Call Control command to define which action will be taken next.

data.outbound.channel_limit

integer

When set, this will limit the total number of inbound calls to phone numbers associated with this connection.

data.outbound.generate_ringback_tone

boolean

default:false

Generate ringback tone through 183 session progress message with early media.

data.outbound.instant_ringback_enabled

boolean

default:false

When set, ringback will not wait for indication before sending ringback tone to calling party.

data.outbound.ip_authentication_method

enum<string>

default:ip-authentication

Available options:

credential-authentication,

ip-authentication

Example:

"credential-authentication"

data.outbound.ip_authentication_token

string

data.outbound.localization

string

default:US

A 2-character country code specifying the country whose national dialing rules should be used. For example, if set to US then any US number can be dialed without preprending +1 to the number. When left blank, Telnyx will try US and GB dialing rules, in that order, by default.",

Example:

"US"

data.outbound.outbound_voice_profile_id

string<int64>

Identifies the associated outbound voice profile.

Example:

"1293384261075731499"

data.outbound.t38_reinvite_source

enum<string>

default:customer

This setting only affects connections with Fax-type Outbound Voice Profiles. The setting dictates whether or not Telnyx sends a t.38 reinvite. By default, Telnyx will send the re-invite. If set to customer, the caller is expected to send the t.38 reinvite.

Available options:

telnyx,

customer,

disabled,

passthru,

caller-passthru,

callee-passthru

data.outbound.tech_prefix

string

Numerical chars only, exactly 4 characters.

data.outbound.encrypted_media

enum<string> | null

Enable use of SRTP for encryption. Cannot be set if the transport_portocol is TLS.

Available options:

SRTP,

Example:

"SRTP"

data.outbound.timeout_1xx_secs

integer

default:3

Time(sec) before aborting if connection is not made.

Required range: 1 <= x <= 120

data.outbound.timeout_2xx_secs

integer

default:90

Time(sec) before aborting if call is unanswered (min: 1, max: 600).

Required range: 1 <= x <= 600

OAuth Discovery

IP Addresses

IP Ranges

SIM Cards

Addresses

Advanced Number Orders

Assistants

Audio

Chat

Clusters

Conversations

Embeddings

Fine Tuning

Integrations

MCP Servers

Audit Logs

Authentication Providers

Phone Number Search

Billing

Billing Groups

Brands

SIM Card Actions

Bundles

User Bundles

Call Control Applications

Debugging

Call Commands

Call Information

Campaign

Voice Channels

API Reference

Phone Number Orders

Conference Commands

Connections

Country Coverage

Credential Connections

Call Recordings

Customer Service Record

Detail Records

Dialogflow Integration

Documents

Dynamic Emergency Addresses

Dynamic Emergency Endpoints

Enum

External Connections

Programmable Fax Applications

Programmable Fax Commands

FQDN Connections

FQDNs

Global IPs

Inexplicit Number Orders

Integration Secrets

Inventory Level

IP Connections

IPs

Reports

MDR Detailed Reports

Speech to Text Batch Reports

CDR Reports

MDR Usage Reports

Telco Data Usage Reports

Speech to text Usage Reports

CDR Usage Reports

Managed Accounts

Media Storage API

Messages

RCS messaging

Messaging Hosted Number

Number Configurations

Advanced OptIn/OptOut

Messaging Profiles

Messaging Tollfree Verification

Messaging URL Domains

Mobile Network Operators

Push Credentials

Coverage

Networks

Notifications

Phone Number Block Orders

Number Lookup