Tunnels

Retrieve a Tunnel

Changed on

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

get/tunnels/{id}

Request

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

Path parameters

idstring uuid required
Example:62d438d2-8a51-4c5e-9d0c-1f6b2a7e4c39

The id of the tunnel.

Response

Successful response.

Example response

{
  "data": {
    "id": "62d438d2-8a51-4c5e-9d0c-1f6b2a7e4c39",
    "record_type": "tunnel",
    "name": "chicago-dc",
    "status": "healthy",
    "connection_count": 2,
    "connections": [
      {
        "hostname": "dc1-tunnel-a",
        "version": "0.6.0",
        "region_code": "chicago-il",
        "connected_at": "2026-10-21T15:04:05.123456Z"
      }
    ],
    "created_at": "2026-10-21T15:04:05.123456Z"
  }
}

Changes