---
title: "Wireless device health grid"
method: POST
path: "/dashboard/wireless/device-health/grid"
tags: ["Dashboard Wireless Device Health"]
---

# Wireless device health grid

`POST /dashboard/wireless/device-health/grid`

Returns the device health grid of wireless devices based on the provided filters. The results can be filtered by sites.

## Query parameters

- `page` integer
- `limit` integer
- `keyword` string
- `sortField` 'HOSTNAME' | 'SITE' | 'CPU_USAGE_PERCENTAGE' | 'MEMORY_USAGE_PERCENTAGE' | 'TOTAL_ETH0_SCORE' | 'TOTAL_ETH1_SCORE'
- `sortOrder` 'ASC' | 'DESC' — Sort Order
- `includeUnassigned` boolean

## Request body

- XiqWirelessDeviceHealthGridFilter — Request body for Wireless Device Health Grid Filter
  - `site_ids` integer[] — List of site ids
  - `device_ids` integer[] — List of device ids
  - `has_device_health_issues` boolean — Flag to filter device health issue
  - `has_poe_issues` boolean — Flag to filter poe issue
  - `number_filter` XiqNumberFilter[] — Object of CPU Usage Percentage
    - `column_name` string — The column name
    - `filter_type` 'GT' | 'GTE' | 'LT' | 'LTE' | 'EQ' | 'NEQ' | 'BTW' | 'BLANK' | 'NOT_BLANK' — The filter type
    - `value` integer — The value
    - `min` integer — The minimum value
    - `max` integer — The maximum value

## Response `200`

OK

- PagedXiqDeviceHealthGridResponse
  - `page` integer, required — The current page number
  - `count` integer, required — The element count of the current page
  - `total_pages` integer, required — The total page number based on request page size
  - `total_count` integer, required — The total element count
  - `data` XiqDeviceHealthGridResponse[] — The data in the current page
    - `hostname` string — The hostname of the device
    - `device_ip` string — The IP address of the device
    - `site` string — The site where the device is located
    - `building` string — The building where the device is located
    - `floor` string — The floor where the device is located
    - `cpu_usage_percentage` integer — Percentage of CPU utilisation
    - `memory_usage_percentage` integer — Percentage of memory utilisation
    - `poe_usage_indicator` boolean — Indicates whether PoE usage is within acceptable limits (device has adequate power supply)
    - `channel_change_count` integer — The count for channel change for the device
    - `wifi_reboots_count` integer — The count for Wi-Fi reboots for the device
    - `eth0_unicast_score` integer — Unicast score for Eth0 interface
    - `eth0_broadcast_score` integer — Broadcast score for Eth0 interface
    - `eth0_multicast_score` integer — Multicast score for Eth0 interface
    - `eth1_unicast_score` integer — Unicast score for Eth1 interface
    - `eth1_broadcast_score` integer — Broadcast score for Eth1 interface
    - `eth1_multicast_score` integer — Multicast score for Eth1 interface
    - `device_id` integer — The device id
    - `has_device_health_issue` boolean — Flag to indicate if device has device health issue

---

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