---
title: "Get list of agent tunnels"
method: GET
path: "/v1/agent-tunnels"
tags: ["Agent Tunnels"]
---

# Get list of agent tunnels

`GET /v1/agent-tunnels`

Retrieve all currently connected agent tunnels, both bound to nodes and unbound (waiting
for bind). Requires MANAGE_AGENT_TUNNELS system access right.

## Response `200`

List of agent tunnels.

- AgentTunnel[]
  - `id` integer — Tunnel ID (valid only while tunnel is connected)
  - `guid` string, uuid
  - `nodeId` integer — ID of the node tunnel is bound to, 0 if unbound
  - `bound` boolean
  - `inbound` boolean — True for tunnels initiated by agent, false for outbound tunnels initiated by server
  - `address` InetAddress
    - `family` integer — IP address family
    - `address` string — IP address in text form. Omitted entirely for unset (AF_UNSPEC) addresses.
    - `prefixLength` integer — IP address prefix length
  - `zoneUIN` integer
  - `systemName` string, nullable
  - `systemInformation` string, nullable
  - `hostname` string
  - `platformName` string, nullable
  - `agentVersion` string, nullable
  - `agentBuildTag` string, nullable
  - `agentId` string, uuid
  - `hardwareId` string, nullable — Hardware ID as hex string, null if agent did not report one
  - `serialNumber` string, nullable
  - `activeChannelCount` integer
  - `userAgentInstalled` boolean
  - `agentProxy` boolean
  - `snmpProxy` boolean
  - `snmpTrapProxy` boolean
  - `syslogProxy` boolean
  - `certificateIssuer` string, nullable
  - `certificateSubject` string, nullable
  - `certificateExpirationTime` string, date-time, nullable
  - `externallyProvisionedCertificate` boolean
  - `connectionTime` string, date-time, nullable

## Other responses

- `401` — Unauthorized.
- `403` — Access denied.

## Changes

- **2026-09-30** `500c0eebeca8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/agent-tunnels/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/129789f8868f?raw)