---
title: "Retrieve a Tunnel"
method: GET
path: "/tunnels/{id}"
tags: ["Tunnels"]
---

# Retrieve a Tunnel

`GET /tunnels/{id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/tunnels/{id}`
- Auth: HTTP bearer

Retrieves a tunnel with its status and the tunnel processes connected to it. The response never includes `tunnel_token`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful response.

- object
  - `data` Tunnel
    - `id` string, uuid: Identifies the resource.
    - `record_type` string: Identifies the type of the resource.
    - `name` string: A user specified name for the tunnel.
    - `status` 'inactive' | 'healthy' | 'degraded': `inactive` when no tunnel process is connected, and `healthy` when one or more are. `degraded` (Preview, not reported yet) when a process is connected but fails to reach its destinations.
    - `connection_count` integer: The number of tunnel processes connected with the tunnel's token.
    - `connections` TunnelConnection[]: The tunnel processes connected with the tunnel's token.
      - `hostname` string: The name the host reports for itself. Preview: empty until the CLI reports it.
      - `version` string: The `telnyx-edge` CLI version of the process. Preview: empty until the CLI reports it.
      - `region_code` string: The Telnyx region the process is connected to. Preview: empty until the CLI reports it.
      - `connected_at` string, date-time: When the process connected.
    - `created_at` string, date-time: ISO 8601 formatted date-time indicating when the resource was created.

## Other responses

- `404`: Not found: no tunnel with this id exists on the account.
- `default`: Unexpected error

## Changes

- **2026-10-26** `0f17b8167873`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/tunnels/:id/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)