---
title: "Gateway Details"
method: GET
path: "/network-monitoring/v1/gateways/{serial-number}"
tags: ["Gateways"]
---

# Gateway Details

`GET /network-monitoring/v1/gateways/{serial-number}`

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-monitoring/v1/gateways/{serial-number}`
- 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/gateways/:serial-number/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves detailed information about a specific gateway including macAddress, deviceName, status and more.

## Path parameters

- `serial-number` string, required: The gateway serial number.

## Response `200`

Object containing information about the gateway, such as MAC address, name, status, uplinks, ports, and VLANs.

- GatewayResponse
  - `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.

## Other responses

- `400`: Invalid input received.
- `401`: Unauthorized. Authentication credentials are required or invalid.
- `403`: Forbidden: Access is denied.
- `404`: Not Found error.
- `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)