---
title: "List connections"
method: GET
path: "/connections"
tags: ["Connections"]
---

# List connections

`GET /connections`

Returns a list of your connections irrespective of type.

## Query parameters

- `filter` object
  - `connection_name` object — Filter by connection_name using nested operations
    - `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.
  - `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.
  - `outbound_voice_profile_id` string — Identifies the associated outbound voice profile.
- `sort` 'created_at' | 'connection_name' | 'active'
- `page[number]` integer
- `page[size]` integer

## Response `200`

Successful response with a list of connections.

- object
  - `data` Connection[]
    - `id` string — Identifies the specific resource.
    - `record_type` string — Identifies the type of the resource.
    - `active` boolean — Defaults to true
    - `anchorsite_override` 'Latency' | 'Chicago, IL' | 'Ashburn, VA' | 'San Jose, CA' | 'Sydney, Australia' | 'Amsterdam, Netherlands' | 'London, UK' | 'Toronto, Canada' | 'Vancouver, Canada' | 'Frankfurt, Germany' — `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` string, uri, nullable — The URL where webhooks related to this connection will be sent.
    - `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.
    - `webhook_api_version` '1' | '2' — Determines which webhook format will be used, Telnyx API v1 or v2.
    - `outbound_voice_profile_id` string — Identifies the associated outbound voice profile.
    - `tags` string[] — Tags associated with the connection.
  - `meta` ConnectionsPaginationMeta
    - `total_pages` integer, required
    - `total_results` integer
    - `page_number` integer, required
    - `page_size` integer

## Other responses

- `400` — Bad request, the request was unacceptable, often due to missing a required parameter.
- `401` — Unauthorized
- `403` — The user doesn't have the required permissions to perform the requested action.

---

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