---
title: "Get Device Tunnel Status"
method: GET
path: "/d360/device/tunnel-status"
tags: ["D360"]
---

# Get Device Tunnel Status

`GET /d360/device/tunnel-status`

Returns the tunnel policy status for a device, including the state of primary, secondary, and tertiary tunnel endpoints. Instead of raw IP addresses, the Tunnel Concentrator Service name is resolved where possible.

## Query parameters

- `deviceId` integer, required

## Response `200`

OK

- XiqDeviceTunnelStatus[]
  - `tunnel_policy_name` string — The name of the tunnel policy
  - `primary` XiqTunnelEndpointStatus — Status information for a single tunnel endpoint
    - `service_name` string — The name of the Tunnel Concentrator Service. Falls back to IP address if name cannot be determined.
    - `ip_address` string — The IP address of the tunnel endpoint
    - `state` string — The current state of the tunnel endpoint
    - `client_count` integer — The number of clients connected through this tunnel endpoint
    - `mtu_state` string — MTU path-detection result for this tunnel endpoint. NORMAL indicates configured MTU fits the GRE path. MTU_FAIL indicates MTU is too large. ICMP_FAIL indicates ICMP cannot traverse the tunnel.
    - `mtu_configured` integer — Configured MTU value of the mgt0 management interface in bytes.
  - `secondary` XiqTunnelEndpointStatus — Status information for a single tunnel endpoint
    - `service_name` string — The name of the Tunnel Concentrator Service. Falls back to IP address if name cannot be determined.
    - `ip_address` string — The IP address of the tunnel endpoint
    - `state` string — The current state of the tunnel endpoint
    - `client_count` integer — The number of clients connected through this tunnel endpoint
    - `mtu_state` string — MTU path-detection result for this tunnel endpoint. NORMAL indicates configured MTU fits the GRE path. MTU_FAIL indicates MTU is too large. ICMP_FAIL indicates ICMP cannot traverse the tunnel.
    - `mtu_configured` integer — Configured MTU value of the mgt0 management interface in bytes.
  - `tertiary` XiqTunnelEndpointStatus — Status information for a single tunnel endpoint
    - `service_name` string — The name of the Tunnel Concentrator Service. Falls back to IP address if name cannot be determined.
    - `ip_address` string — The IP address of the tunnel endpoint
    - `state` string — The current state of the tunnel endpoint
    - `client_count` integer — The number of clients connected through this tunnel endpoint
    - `mtu_state` string — MTU path-detection result for this tunnel endpoint. NORMAL indicates configured MTU fits the GRE path. MTU_FAIL indicates MTU is too large. ICMP_FAIL indicates ICMP cannot traverse the tunnel.
    - `mtu_configured` integer — Configured MTU value of the mgt0 management interface in bytes.
  - `total_client_count` integer — Total number of clients across all active tunnel endpoints
  - `has_failed_endpoint` boolean — Whether any endpoint is in FAIL state
  - `last_updated` integer — Timestamp when the tunnel state was last updated (Unix timestamp in milliseconds)

---

[API](https://skmtc.dev/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.dev/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/revisions/5cefd06a809b/schema)