---
title: "Get a list of Radios"
method: GET
path: "/network-monitoring/v1/radios"
tags: ["Access Points"]
---

# Get a list of Radios

`GET /network-monitoring/v1/radios`

This API endpoint retrieves a list of radios associated to a customer, based on the query parameters provided. Each radio in the returned list includes comprehensive details like serial number, device name, MAC address, band, status and its current statistics . The query parameters allow you to narrow down the results to radios that meet specific criteria, ensuring you receive only the relevant data.

## Query parameters

- `filter` string, const
- `sort` string, const
- `limit` integer
- `next` string — Specifies the pagination cursor for the next page of resources.

## Response `200`

List of Radios, along with their details and associated pagination information.

- RadioListResponseV1
  - `items` object[], required
    - `serialNumber` string, const, required — The access point serial number.
    - `deviceName` string, const, required — The access point name.
    - `macAddress` string, const, required — The radio MAC address.
    - `status` 'UP' | 'DOWN' | 'DISABLED', required — Represents the operational status of the radio.
    - `band` string, required — Specifies the frequency band on which the radio operates.
    - `bandRange` string — Defines the range of the frequency band used by the radio.
    - `channel` integer — A channel identifier for a given frequency band.
    - `bandwidth` string — Indicates the channel bandwidth.
    - `mode` string — Describes the operational mode of the radio.
    - `radioNumber` integer, required — The radio number within an access point
    - `power` string — Specifies the power level in dBm at which the radio is operating.
    - `siteId` string, const, required — The unique identifier of the site to which the access point has been assigned.
    - `siteName` string, const — SiteName represents the name of the site where the device is located. This name is used to identify and manage devices based on their physical location, allowing for better organization and tracking.
    - `channelUtilization` string — Represents the percentage of channel utilization by the radio.
    - `nonWifiInterference` string — Indicates the level of non-WiFi interference affecting the radio.
    - `txUtilization` string — Represents the percentage of transmission utilization by the radio.
    - `rxUtilization` string — Represents the percentage of reception utilization by the radio.
    - `noiseFloor` string — Represents the noise floor level measured by the radio.
    - `drops` string — Indicates the drop frames percentage.
    - `retries` string — Indicates the retry frames percentage.
    - `channelQuality` string — Represents the quality of the channel used by the radio as a percentage.
    - `channelChangeCount` integer — The number of times the channel has been changed in last 3 hours.
    - `powerChangeCount` integer — The number of times the power has been changed in last 3 hours.
    - `radioType` string — The type of wireless LAN used for the radios.
    - `antenna` string — Antenna type of the radio. Possible values are Internal or External.
    - `spatialStream` string — Number of spatial data streams supported by the radio.
    - `clientCount` integer
    - `id` string, const, required — Primary identifier for a radio under an access point.
    - `type` string, const, required — The type of the resource.
  - `count` integer, required — Number of items in the response.
  - `total` integer — Specifies the total number of items available for a given filter query.
  - `next` string, int32, required — Indicate the next page number, null if there are no further pages.

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