---
title: "List the summary of device details"
method: GET
path: "/d360/overview/devices-summary"
tags: ["D360"]
---

# List the summary of device details

`GET /d360/overview/devices-summary`

List the summary of device details.

## Query parameters

- `deviceId` integer, required

## Response `200`

OK

- XiqD360DeviceSummary
  - `connected_status` boolean — The connected status of the device
  - `active_since` integer — The timestamp when the device became active. Unix timestamp in milliseconds since epoch.
  - `device_health_issues` integer
  - `usage_and_capacity_issues` integer
  - `client_health_issues` integer
  - `device_details` XiqDeviceDetails — The device details
    - `system_name` string — The system name of the device.
    - `ip_address` string — Management IP address. Supports IPv4 (e.g., 192.0.2.1) or IPv6 (e.g., 2001:db8::1). Prefer canonical presentation; use separate fields or oneOf if you need strict validation.
    - `model` string — The device model name or number.
    - `sys_up_time` string — System uptime duration. Represented in seconds (integer) or as an ISO-8601 duration string (e.g., PT1H). Preferred representation: seconds.
    - `os_version` string — The operating system version of the device.
    - `location` string — The physical location of the device.
    - `system_mac` string — List of device MAC addresses to filter. Each MAC may be 12 hex characters (no separators) or use colon/dash delimiters.
    - `serial_number` string — The serial number of the device.
    - `system_description` string — A detailed description of the device system.
    - `software_version` string — The software version running on the device.
    - `installation_time` string, date-time — The timestamp when the device was installed.
    - `device_license_tier` 'NOT_APPLICABLE' | 'TIER_A' | 'TIER_B' | 'TIER_C' | 'TIER_D' | 'UNKNOWN' | 'NONE' | 'TIER_3RD' — The license tier of the device
    - `device_license_type` 'LEGACY' | 'NAVIGATOR' | 'PILOT' | 'COPILOT' | 'NONE' | 'NA' | 'TRIAL' | 'NOT_REQUIRED' | 'GRACEPERIOD' | 'UNLICENSED' | 'STANDARD' | 'ADVANCED' | 'NOT_LICENSED' — The license type of the device
  - `system_information` XiqDeviceSystemInformation
    - `host_name` string — The name of the host
    - `network_policy` string — The network policy applied to the device
    - `ssids` string[] — The SSID of the network
    - `device_model` string — The model of the device
    - `function` 'AP' | 'ROUTER' | 'ROUTER_AS_L2_VPN_GATEWAY' | 'ROUTER_AS_L3_VPN_GATEWAY' | 'SWITCH' | 'SWITCH_HAC' | 'SWITCH_DELL' | 'L2_VPN_GATEWAY' | 'L3_VPN_GATEWAY' | 'IQ_CONTROLLER' — The device function, such as AP, Router, Switch, etc.
    - `device_template` string — The configuration template applied to the device
    - `configuration_type` 'DEFAULT' | 'TEMPLATE' | 'CUSTOM' — The device configuration type. Possible values: DEFAULT (factory default), TEMPLATE (applied from a template), CUSTOM (user-configured).
    - `serial_number` string — The serial number of the device
    - `iq_engine` string — The IQ engine version or type used by the device
    - `device_status` 'NEW' | 'BOOTSTRAP' | 'STAGED' | 'MANAGED' | 'UNMANAGED'
    - `mgt0_ipv4_address` string — Management IPv4 address
    - `mgt0_ipv6_address` string — Management IPv6 address
    - `ipv4_subnet_mask` string — The IPv4 subnet mask in dotted-decimal notation.
    - `ipv6_subnet_mask` string — The IPv6 subnet mask or prefix length. Accepted formats: numeric prefix length (e.g., "64") or CIDR notation with an IPv6 network (e.g., "2001:db8::/64").
    - `ipv4_default_gateway` string — The IPv4 default gateway address
    - `ipv6_default_gateway` string — The IPv6 default gateway address
    - `mgt0_macaddress` string — The MAC address of the management interface in six hex byte pairs (colon or hyphen separated).
    - `dns` string — The DNS server address(es). Either a single IPv4 or IPv6 address, or a comma-separated list of addresses. Spaces around commas are allowed.
    - `ntp` string — The NTP server address(es). Either a single hostname or IP (IPv4/IPv6), or a comma-separated list of addresses. Spaces around commas are allowed.

---

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