---
title: "List all Tunnels"
method: GET
path: "/tunnels"
tags: ["Tunnels"]
---

# List all Tunnels

`GET /tunnels`

## Request

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

Lists the tunnels on the account with their status and connected tunnel processes. Responses never include `tunnel_token`.

## Query parameters

- `filter` object
  - `name` string: The name of the tunnel.
  - `status` 'inactive' | 'healthy' | 'degraded': The status of the tunnel.
- `sort` 'name' | '-name' | 'status' | '-status' | 'created_at' | '-created_at' | 'updated_at' | '-updated_at'
- `page` object
  - `after` string: The cursor from `meta.cursors.after` of the previous page.
  - `limit` integer: The number of results per page.

## 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.
  - `meta` NetappsCursorPaginationMeta
    - `cursors` object: Opaque cursors. Absent keys mean there is no such page.
      - `after` string: Pass as `page[after]` to fetch the next page. Absent on the last page.
      - `before` string: The cursor of the previous page. Present when the request used `page[after]`.
    - `next` string: The path of the next page, with the same query parameters. Absent on the last page.
    - `previous` string: The path of the previous page. Present when the request used `page[after]`.

## Other responses

- `422`: Unprocessable entity: a query parameter is not valid, such as an unsupported `sort` field.
- `default`: Unexpected error

## Changes

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

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/tunnels/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)