---
title: "Get device info for a specific device"
method: GET
path: "/devices/{id}"
tags: ["Device"]
---

# Get device info for a specific device

`GET /devices/{id}`

Get device info for a specific device.

## Path parameters

- `id` integer, required

## Query parameters

- `views` XiqDeviceView[]
- `fields` XiqDeviceField[]

## Response `200`

OK

- XiqDeviceResponse — Generic ExtremeCloud IQ Device model
  - `id` integer, required — The unique identifier
  - `create_time` string, date-time, required — The create time in UTC (ISO 8601 format)
  - `update_time` string, date-time, required — The last update time in UTC (ISO 8601 format)
  - `org_id` integer — The organization identifier, valid when enabling HIQ feature
  - `serial_number` string — The device serial number, valid for all non-HAC devices
  - `service_tag` string — The device service tag, valid for all HAC devices
  - `mac_address` string — The device MAC address
  - `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.
  - `product_type` string — The product type, such as: AP_230, BR_100, NX9600, etc.
  - `hostname` string — The device hostname
  - `ip_address` string — The device IPv4 address
  - `software_version` string — The device OS software version
  - `device_admin_state` 'NEW' | 'BOOTSTRAP' | 'STAGED' | 'MANAGED' | 'UNMANAGED'
  - `connected` boolean — The device connection status
  - `last_connect_time` string, date-time — The device last connect time
  - `network_policy_name` string — The network policy name for the device
  - `network_policy_id` integer — The network policy ID for the device
  - `primary_ntp_server_address` string — The primary NTP server address for the device
  - `primary_dns_server_address` string — The primary DNS server address for the device
  - `subnet_mask` string — The subnet mask for the device
  - `default_gateway` string — The default gateway for the device
  - `ipv6_address` string — The ipv6 address for the device
  - `ipv6_netmask` integer — The ipv6 netmask for the device
  - `simulated` boolean — The device is simulated or not
  - `display_version` string — The display version for the device
  - `active_clients` integer — The active client count for the device
  - `location_id` integer — The location ID for the device
  - `locations` XiqLocationLegendDetails[] — The detailed location
    - `id` integer — The location ID
    - `name` string — The location name
    - `folder_type` 'SITE' | 'BUILDING' | 'FLOOR' | 'GENERIC' — Folder type
  - `country_code` integer — The assigned country code on the device
  - `description` string — The device description
  - `lldp_cdp_infos` XiqDeviceLldpCdpInfo[] — The device LLDP/CDP information
    - `port_id` string — The port ID.
    - `system_id` string — The system ID.
    - `system_name` string — The system name.
    - `interface_name` string — The interface name.
    - `management_ip` string — The management IP.
    - `port_description` string — The port description.
  - `system_up_time` integer — The device uptime
  - `config_mismatch` boolean — Config audit status(MATCHED or UNMATCHED)
  - `managed_by` string — The managed application for the device
  - `thread0_eui64` string — Thread router EUI64
  - `thread0_ext_mac` string — Thread router extended MAC address
  - `mgt_vlan` integer — Management VLAN
  - `images_names` string[] — List of images assigned to this device
  - `visible` boolean — The visible status of a device in a floor.
  - `subscription_license` string — The Subscription License of the device.

---

[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)