Skip to main content

List connections

GET 

/connections

Returns a list of your connections irrespective of type.

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[connection_name][contains] string

    If present, connections with connection_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, connection_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:

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

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

Responses

200: Successful response with a list of connections.

Schema

    data

    object[]

  • Array [

  • id int64

    Identifies the specific resource.

    record_type string

    Identifies the type of the resource.

    active boolean

    Defaults to true

    anchorsite_override Anchorsite Override

    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.

    connection_name string
    created_at string

    ISO 8601 formatted date indicating when the resource was created.

    updated_at string

    ISO 8601 formatted date indicating when the resource was updated.

    webhook_event_url urlnullable

    The URL where webhooks related to this connection will be sent.

    webhook_event_failover_url urlnullable

    The failover URL where webhooks related to this connection will be sent if sending to the primary URL fails.

    webhook_api_version string

    Possible values: [1, 2]

    Default value: 1

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

    outbound_voice_profile_id int64

    Identifies the associated outbound voice profile.

  • ]

  • 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
  • ]

Loading...