---
title: "Wired Usage and Capacity grid"
method: POST
path: "/dashboard/wired/usage-capacity/grid"
tags: ["Dashboard Wired Usage and Capacity"]
---

# Wired Usage and Capacity grid

`POST /dashboard/wired/usage-capacity/grid`

Returns information related to usage and capacity for wired devices based on the provided filters. The result can be filtered by sites.

## Query parameters

- `page` integer
- `limit` integer
- `keyword` string
- `sortField` 'UNSPECIFIED' | 'DEVICE_HOSTNAME' | 'DEVICE_IP' | 'SITE' | 'TOTAL_CLIENTS_COUNT' | 'TOTAL_ISSUE_CLIENTS_COUNT' | 'TOTAL_BANDWIDTH_UTILIZED' | 'TOTAL_THROUGHPUT_RX' | 'TOTAL_THROUGHPUT_TX' | 'TOTAL_UNICAST_PACKETS' | 'TOTAL_MULTICAST_PACKETS' | 'TOTAL_BROADCAST_PACKETS' | 'TOTAL_QUEUE_TX_PKTS' | 'TOTAL_QUEUE_CONGESTION_PKTS'
- `sortOrder` 'ASC' | 'DESC' — Sort Order

## Request body

- XiqWiredUsageCapacityGridRequest — Request body for Wired Usage and Capacity grid
  - `site_ids` integer[] — List of site IDs to filter usage and capacity grid
  - `device_ids` integer[] — List of device IDs to filter usage and capacity grid
  - `filter_field` XiqWiredUsageAndCapacityFilterType[] — The filters available for usage and capacity grid

## Response `200`

OK

- PagedXiqWiredUsageCapacityGridResponse
  - `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` XiqWiredUsageCapacityGridResponse[] — The data in the current page
    - `device_id` integer — The unique device identifier
    - `device_hostname` string — The hostname of the device
    - `device_ip` string — The IP address of the device
    - `is_stack` boolean — Indicates whether the device is a stack or not
    - `site` string — Site location of the device
    - `building` string — The building where the device is located
    - `floor` string — The floor where the device is located
    - `total_clients_count` integer — Total number of clients of the device
    - `total_issue_clients_count` integer — Total number of clients with issues of the device
    - `total_bandwidth_utilized` integer — Total utilized bandwidth in Bytes
    - `total_throughput_rx` integer — Total Rx throughput in packets per second
    - `total_throughput_tx` integer — Total Tx throughput in packets per second
    - `total_unicast_pkts` integer — The percentage of unicast packets from total number of packets
    - `total_multicast_pkts` integer — The percentage of multicast packets from total number of packets
    - `total_broadcast_pkts` integer — The percentage of broadcast packets from total number of packets
    - `total_queue_tx_pkts` integer — Total number of transmitted packets on all QOS queues
    - `total_queue_congestion_pkts` integer — Total number of packets dropped due to congestion on all QOS queues
    - `total_packets_count` integer — Total number of unicast, multicast and broadcast packets

---

[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/revisions/5ff7ab84e8e8/schema)