---
title: "List all External Connections"
method: GET
path: "/external_connections"
tags: ["External Connections"]
---

# List all External Connections

`GET /external_connections`

This endpoint returns a list of your External Connections inside the 'data' attribute of the response. External Connections are used by Telnyx customers to seamless configure SIP trunking integrations with Telnyx Partners, through External Voice Integrations in Mission Control Portal.

## Query parameters

- `filter` object
  - `connection_name` object
    - `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.
  - `created_at` string — If present, connections with <code>created_at</code> date matching the given YYYY-MM-DD date will be returned.
  - `external_sip_connection` 'zoom' | 'operator_connect' — If present, connections with <code>external_sip_connection</code> matching the given value will be returned.
  - `id` string — If present, connections with <code>id</code> matching the given value will be returned.
  - `phone_number` object — Phone number filter for connections. Note: Despite the 'contains' name, this requires a full E164 match per the original specification.
    - `contains` string — If present, connections associated with the given phone_number will be returned. A full match is necessary with a e164 format.
- `page` object
  - `number` integer — The page number to load
  - `size` integer — The size of the page

## Response `200`

Successful response

- object
  - `data` ExternalConnection[]
    - `active` boolean — Specifies whether the connection can be used.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `credential_active` boolean — If the credential associated with this service is active.
    - `external_sip_connection` 'zoom' | 'operator_connect' — The service that will be consuming this connection.
    - `id` string — Uniquely identifies the resource.
    - `inbound` object
      - `channel_limit` integer — When set, this will limit the number of concurrent inbound calls to phone numbers associated with this connection.
    - `outbound` object
      - `channel_limit` integer — When set, this will limit the number of concurrent outbound calls to phone numbers associated with this connection.
      - `outbound_voice_profile_id` string — Identifies the associated outbound voice profile.
    - `record_type` string — Identifies the type of the resource.
    - `tags` string[] — Tags associated with the connection.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.
    - `webhook_api_version` '1' | '2' — Determines which webhook format will be used, Telnyx API v1 or v2.
    - `webhook_event_failover_url` string, uri, nullable — 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'.
    - `webhook_event_url` string, uri — The URL where webhooks related to this connection will be sent. Must include a scheme, such as 'https'.
    - `webhook_timeout_secs` integer, nullable — Specifies how many seconds to wait before timing out a webhook.
  - `meta` ExternalVoiceIntegrationsPaginationMeta
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)