---
title: "List a tunnel's live connections to the provider's edge."
method: GET
path: "/ingress/connectors/{id}/links"
tags: ["Ingress"]
---

# List a tunnel's live connections to the provider's edge.

`GET /ingress/connectors/{id}/links`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/ingress/connectors/{id}/links`
- Auth: HTTP bearer

Read from the provider on request: each link's data centre, when it
opened, whether it is reconnecting, and the worker holding it.

## Path parameters

- `id` integer, required

## Response `200`

- ConnectorLinksView: A tunnel's live connections, read from the provider on request.
  - `links` LinkView[], required
    - `client_version` string, nullable
    - `location` string, nullable: The provider's data centre, such as `mad01`.
    - `node_id` integer, nullable: The worker holding it, when its connector could be matched.
    - `node_name` string, nullable
    - `opened_at` string, nullable
    - `reconnecting` boolean, required
  - `status` string, required: The provider's own word for the tunnel (Cloudflare: `healthy`, `degraded`, `down`, `inactive`).

## Other responses

- `400`: The tunnel is not created yet
- `404`
- `502`: The provider could not be asked

## Changes

> 98 revisions in range; 1 not diffed.

- **2026-10-22** `d8a717162ef5`: 1 info
  - endpoint added
- **2026-10-22** `06005615b19e`: 1 breaking
  - api path removed without deprecation
- **2026-10-22** `7d41b820a372`: 1 info
  - endpoint added
- **2026-10-22** `add7f7b41ae2`: 1 breaking
  - api path removed without deprecation
- **2026-10-21** `842d42ed4659`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gotempsh/apis/temps/changes/ingress/connectors/:id/links/get.md)

---

[API](https://skmtc.dev/gotempsh/apis/temps.md) - [All operations](https://skmtc.dev/gotempsh/apis/temps/llms.txt) - [OpenAPI document](https://skmtc.dev/gotempsh/apis/temps/revisions/fdfa2df06ae7?raw)