---
title: "Get high wired bandwidth usage Access Points"
method: GET
path: "/network-monitoring/v1/top-aps-by-wired-usage"
tags: ["Access Points"]
---

# Get high wired bandwidth usage Access Points

`GET /network-monitoring/v1/top-aps-by-wired-usage`

The API will retrieve a list of the top access points ranked by their wired bandwidth usage, sorted in descending order, for a specified site and time period.

## Query parameters

- `site-id` string, uuid — Id of a site where devices are associated.
- `site-name` string, const — Name of the Site in which the device is present.
- `limit` integer
- `start-at` string, date-time — Date-time in RFC 3339 format (ISO 8601) in UTC timezone with milliseconds.
- `end-at` string, date-time — Date-time in RFC 3339 format (ISO 8601) in UTC timezone with milliseconds.

## Response `200`

A list of access point (AP) serial numbers along with their respective bandwidth usage. The list is sorted in descending order based on bandwidth usage. If there is no data, an empty list will be returned.

- TopAccessPointsResponse
  - `items` TopAccessPoint[], required — The list of access points bandwidth usage
    - `serialNumber` string, const, required — The access point serial number.
    - `deviceName` string, const, required — The access point name.
    - `totalValue` number, double, required — The overall amount of bandwidth used by the access point
    - `units` 'Bytes', required — The unit for measuring bandwidth usage value is set to Bytes by default.
    - `id` string, const, required — Primary identifier for the resource.
    - `type` string, const, required — The type of the resource.
  - `count` integer, required — Number of items in the response

## Other responses

- `400` — Invalid input received.
- `401` — Unauthorized. Authentication credentials are required or invalid.
- `403` — Forbidden: Access is denied.
- `429` — Too Many Requests. The user has sent too many requests in a given amount of time.
- `500` — Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.net/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.net/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arubanetworks/authorization/revisions/74c95058b11f/schema)