---
title: "List Gateways"
method: GET
path: "/network-monitoring/v1/gateways"
tags: ["Gateways"]
---

# List Gateways

`GET /network-monitoring/v1/gateways`

Retrieves a list of gateways with details like serialNumber, deviceName, macAddress, siteId, status and more. The query parameters allow you to narrow down the results to gateways that meet specific criteria, ensuring you receive only the relevant data.

## Query parameters

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

## Response `200`

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

- GatewayListResponse
  - `items` object[], required
    - `serialNumber` string, required — The gateway serial number.
    - `macAddress` string, required — The gateway MAC address.
    - `deviceName` string, required — The gateway name.
    - `cpuUtilization` number, float, required — The latest CPU utilization of the gateway.
    - `memoryUtilization` number, float, required — The latest memory utilization of the gateway.
    - `siteId` string, required
    - `firmwareVersion` string, required — Firmware version currently running on the gateway.
    - `ipAddress` string, ipv4, required — IP address of the VLAN.
    - `uptimeInMillis` number, double, required — Elapsed time in milliseconds since the gateway's last boot. This value will be null if the gateway is offline.
    - `macRange` string, required — The MAC address range allocated to the gateway.
    - `rebootReason` string, required — The last reboot reason of the gateway.
    - `deviceFunction` 'Unspecified' | 'Mobility Controller' | 'Branch Gateway' | 'VPNC', required — Device function (Persona identifier) for the gateway.
    - `mode` 'Standalone' | 'Cluster', required — The operating mode of the gateway.
    - `status` 'Online' | 'Offline', required — The status of the gateway, either Online or Offline.
    - `role` 'Isoleader' | 'Leader' | 'Member', required — Role of the gateway in the gateway cluster.
    - `model` string, required — The gateway model.
    - `siteName` string, required — The site to which the gateway is assigned.
    - `clusterName` string, required — The cluster to which the gateway belongs.
    - `id` string, required — Primary identifier for the resource.
    - `type` string, required — The type of the resource.
  - `count` integer, required — The number of items in the response.
  - `total` integer — Specifies the total number of items available for a given filter query.
  - `next` string, int32, required — Indicates the next page number, or 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)