Skip to main content

List all TeXML Applications

GET 
/texml_applications

Returns a list of your TeXML Applications.

Request​

Query Parameters

    page[number] integer

    Possible values: >= 1

    Default value: 1

    The page number to load

    page[size] integer

    Possible values: >= 1 and <= 250

    Default value: 250

    The size of the page

    filter[friendly_name][contains] string

    Default value: null

    If present, applications with friendly_name containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.

    filter[outbound_voice_profile_id] int64

    Identifies the associated outbound voice profile.

    sort string

    Possible values: [created_at, friendly_name, active]

    Default value: created_at

    Specifies the sort order for results. By default sorting direction is ascending. To have the results sorted in descending order add the - prefix.

    That is:

    • friendly_name: sorts the result by the friendly_name field in ascending order.
    • -friendly_name: sorts the result by the friendly_name field in descending order.

    If not given, results are sorted by 
    created_at
    in descending order.

Responses​

200: Successful response

Schema

    data

    object[]

  • Array [

    • id int64

    Uniquely identifies the resource.

    record_type string

    Identifies the type of the resource.

    friendly_name Application Name (string)

    A user-assigned name to help manage the application.

    active Connection Active (boolean)

    Default value: true

    Specifies whether the connection can be used.

    anchorsite_override Anchorsite Override (string)

    Possible values: [Latency, Chicago, IL, Ashburn, VA, San Jose, CA, Sydney, Australia, Amsterdam, Netherlands, London, UK, Toronto, Canada, Vancouver, Canada, Frankfurt, Germany]

    Default value: 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.

    dtmf_type DTMF Type (string)

    Possible values: [RFC 2833, Inband, SIP INFO]

    Default value: 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.

    first_command_timeout First Command Timeout (boolean)

    Specifies whether calls to phone numbers associated with this connection should hangup after timing out.

    first_command_timeout_secs First Command Timeout Secs (integer)

    Default value: 30

    Specifies how many seconds to wait before timing out a dial command.

    voice_url url

    URL to which Telnyx will deliver your XML Translator webhooks.

    voice_fallback_url url

    URL to which Telnyx will deliver your XML Translator webhooks if we get an error response from your voice_url.

    voice_method string

    Possible values: [get, post]

    Default value: post

    HTTP request method Telnyx will use to interact with your XML Translator webhooks. Either 'get' or 'post'.

    status_callback url

    URL for Telnyx to send requests to containing information about call progress events.

    status_callback_method string

    Possible values: [get, post]

    Default value: post

    HTTP request method Telnyx should use when requesting the status_callback URL.

    inbound

    object

    channel_limit integer

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

    shaken_stir_enabled boolean

    When enabled Telnyx will include Shaken/Stir data in the Webhook for new inbound calls.

    sip_subdomain string

    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.

    sip_subdomain_receive_settings string

    Possible values: [only_my_connections, from_anyone]

    Default value: 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).

    outbound

    object

    channel_limit integer

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

    outbound_voice_profile_id int64

    Identifies the associated outbound voice profile.

    created_at Created At (string)

    ISO 8601 formatted date indicating when the resource was created.

    updated_at Updated At (string)

    ISO 8601 formatted date indicating when the resource was updated.

  • ]

    • meta

    object

    total_pages integer
    total_results integer
    page_number integer
    page_size integer

400: Bad request, the request was unacceptable, often due to missing a required parameter.

Schema

    errors

    object[]

  • Array [

    • code string
    detail string

    meta

    object

    url uri
    title string

    source

    object

    pointer string

  • ]

401: Unauthorized

Schema

    errors

    object[]

  • Array [

    • code string
    detail string

    meta

    object

    url uri
    title string

    source

    object

    pointer string

  • ]

403: The user doesn't have the required permissions to perform the requested action.

Schema

    errors

    object[]

  • Array [

    • code string
    detail string

    meta

    object

    url uri
    title string

    source

    object

    pointer string

  • ]

Request samples

curl -L 'https://api.telnyx.com/v2/texml_applications' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

{
  "data": [
    {
      "id": "1293384261075731499",
      "record_type": "texml_application",
      "active": false,
      "friendly_name": "call-router",
      "anchorsite_override": "Amsterdam, Netherlands",
      "dtmf_type": "Inband",
      "first_command_timeout": true,
      "first_command_timeout_secs": 10,
      "voice_url": "https://example.com",
      "voice_fallback_url": "https://fallback.example.com",
      "voice_method": "get",
      "status_callback": "https://example.com",
      "status_callback_method": "get",
      "inbound": {
        "channel_limit": 10,
        "shaken_stir_enabled": true,
        "sip_subdomain": "example",
        "sip_subdomain_receive_settings": "only_my_connections"
      },
      "outbound": {
        "channel_limit": 10,
        "outbound_voice_profile_id": "1293384261075731499"
      },
      "created_at": "2020-02-02T22:25:27.521Z",
      "updated_at": "2020-02-03T22:25:27.521Z"
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}