---
title: "Retrieve a connection"
method: GET
path: "/connections/{id}"
tags: ["Connections"]
---

# Retrieve a connection

`GET /connections/{id}`

Retrieves the high-level details of an existing connection. To retrieve specific authentication information, use the endpoint for the specific connection type.

## Path parameters

- `id` string, required

## Response `200`

Successful response with details about a connection.

- object
  - `data` Connection
    - `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.
    - `id` string — Identifies the specific resource.
    - `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.
    - `webhook_event_url` string, uri, nullable — The URL where webhooks related to this connection will be sent.

## 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.
- `404` — The requested resource doesn't exist.

---

[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)