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

# Get a list of Access Points

`GET /network-monitoring/v1/aps`

This API endpoint retrieves a list of access points associated to a customer, based on the query parameters provided. Each access point in the returned list includes comprehensive details like serial number, name, MAC address, siteId, status and with latest stats. The query parameters allow you to narrow down the results to access points 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 access points, along with their details and associated pagination information.

- AccessPointListResponse
  - `items` object[], required
    - `serialNumber` string, const, required — The access point serial number.
    - `macAddress` string, const, required — The access point MAC address.
    - `deviceName` string, const, required — The access point name.
    - `model` string, const — Hardware model of the access point.
    - `partNumber` string, const — The part number of the access point
    - `deployment` string, const — The operating mode of the access point.
    - `role` string, const — Role of the access point in the network-topology.
    - `deviceFunction` string, const — Device Function (Persona identifier) for the access point.
    - `firmwareVersion` string, const — Firmware version currently running on the access point.
    - `ipv4` string, ipv4 — IPv4 address of the access point.
    - `ipv6` string, ipv6 — IPv6 address of the access point.
    - `publicIpv4` string, ipv4 — Public IP address of the access point.
    - `status` 'ONLINE' | 'OFFLINE' — Status of the access point, which can be either ONLINE or OFFLINE.
    - `lastSeenAt` string, date-time — An RFC 3339 date-time indicating the last detected time of the access point in the system. If the access point is online, this value will be null.
    - `lastRebootReason` string, const — Last reboot reason description: * UNKNOWN: 'Unknown' * AP_RELOAD: 'Reload' * USER_REBOOT: 'User reboot' * WRITE_ERASE_REBOOT: 'Write erase reboot' * WRITE_ERASE_ALL_REBOOT: 'Write erase all reboot' * IMAGE_SYNC_FAILED: 'Image sync failed' * IMAGE_SYNC_SUCCESSFUL: 'Image sync successful' * IMAGE_UPGRADE: 'Image upgrade successful' * IMAGE_DOWNLOAD_FAILURE: 'Image download failure' * OUT_OF_MEMORY: 'Reboot caused by out of memory' * DOWN_UPLINK: 'Current uplink down, no useable uplink.' * CONDUCTOR_TO_LOCAL: 'Conductor transitioned to local' * NETWORK_DISCONNECT_USB_RESET: 'Internet connection lost, reset usb modem' * NETWORK_DISCONNECT: 'Internet connection lost' * UNREACHABLE_GATEWAY: 'Gateway unreachable' * FATAL_EXCEPTION: 'Reboot caused by kernel panic: fatal exception' * FATAL_EXCEPTION_IN_INTERRUPT: 'Reboot caused by kernel panic: fatal exception in interrupt' * SOFTLOCKUP: 'Reboot caused by kernel panic: softlockup: hung tasks' * NTP_SYNC: 'System clock is too far ahead of ntp sync result' * BAD_MESH_LINK: 'Mesh link bad. Rebooting mesh point by sapd' * MESH_TO_PORTAL: 'Mesh point transitioned to portal' * REBOOT_BY_AIRWAVE: 'Reboot by Airwave' * AMP_COMMAND: 'Amp' * VC_COMMAND: 'VC' * REBOOTED_BY_CENTRAL: 'Reboot by Central' * CLOUD_MANAGEMENT_COMMAND: 'Cloud management' * CLI_COMMAND: 'CLI' * CONDUCTOR_IP_FAILURE: 'Failed to get conductor-ip' * NON_FIPS: 'Non-fips --> fips' * FIPS: 'Fips --> non-fips' * TOPOLOGY_CHANGE: 'Rebooting AP due to topology change: hierarchy to flat' * AP_DISCONNECTED: 'AP disconnected from Aruba Central' * VC_DISCONNECTED: 'Virtual controller disconnected from Aruba Central' * COLD_HW_RESET: 'AP reboot caused by cold hw reset(power loss)' * POWER_LOSS: 'AP rebooted due to loss power' * THERMAL_MODE: 'Reboot due to trigger the cooldown event' * OVERHEAT_EVENT: 'Reboot due to trigger the overheat event' * PREEMPTED_BY_CONDUCTOR: 'Preempted by provisioned conductor'
    - `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.
    - `clusterName` string, const — The name of the cluster to which the device belongs. If the device is not part of any cluster then the cluster name will be null.
    - `clusterId` string, const — The unique identifier of the swarm (cluster).
    - `deviceGroupId` string, const — DeviceGroupId property represents the unique identifier for the group to which the device belongs. This identifier is used to group devices that share common characteristics or are part of the same operational group, facilitating easier management and monitoring.
    - `deviceGroupName` string, const — DeviceGroupName represents the name of the group to which the device belongs. This name is used to categorize and manage devices that share common characteristics or are part of the same operational group.
    - `cpuUtilization` integer — Represents the percentage of CPU utilization by the access point.
    - `memoryUtilization` integer — Represents the percentage of memory utilization by the access point.
    - `powerConsumption` number — Current power drawn by the access point, in watts.
    - `clientCount` integer
    - `wlanCount` integer
    - `subnetMask` string, ipv4 — Subnet mask assigned to the access point IPv4 interface.
    - `meshRole` string — Mesh role of the access point when mesh is configured.
    - `uptimeInMillis` number, double — Elapsed time in milliseconds since the access point's last boot. This value will be null if the access point is offline.
    - `buildingId` string, uuid — Building ID associated with the access point in UUID format. Omitted if no specific building is associated with the access point.
    - `floorId` string, uuid — Floor ID associated with the access point in UUID format. Omitted if no specific floor is associated with the access point.
    - `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.
  - `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/versions/74c95058b11f/schema)