---
title: "Get a list of Access Point radios"
method: GET
path: "/network-monitoring/v1/aps/{serial-number}/radios"
tags: ["Access Points"]
---

# Get a list of Access Point radios

`GET /network-monitoring/v1/aps/{serial-number}/radios`

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-monitoring/v1/aps/{serial-number}/radios`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://sso.common.cloud.hpe.com/as/token.oauth2`
- TypeScript: <https://skmtc.dev/arubanetworks/apis/authorization/docs/network-monitoring/v1/aps/:serial-number/radios/get.ts> (a function with typed inputs; its response is checked against the schema)

This API endpoint retrieves a list of radios associated to an access point. Each radio in the returned list includes comprehensive details like MAC address, band, status and its current statistics.

## Path parameters

- `serial-number` string, const, required: The device serial number.

## Response `200`

List of Radios of an access point, along with their details.

- AccessPointRadioListResponseV1
  - `items` object[], required
    - `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.
    - `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.
    - `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.

## 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.dev/arubanetworks/apis/authorization.md) - [All operations](https://skmtc.dev/arubanetworks/apis/authorization/llms.txt) - [OpenAPI document](https://skmtc.dev/arubanetworks/apis/authorization/revisions/74c95058b11f?raw)