---
title: "Returns topology details for the given site."
method: GET
path: "/network-monitoring/v1/topology/{site-id}"
tags: ["Topology"]
---

# Returns topology details for the given site.

`GET /network-monitoring/v1/topology/{site-id}`

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-monitoring/v1/topology/{site-id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://sso.common.cloud.hpe.com/as/token.oauth2`

This API provides topology for a specific site

## Path parameters

- `site-id` string, const, required

## Response `200`

Success

- Topology: Topology details for a given site
  - `id` string, required: Primary identifier for the resource.
  - `type` string, const, required: API type.
  - `devices` Devices
    - `serial` string: Serial number of the device. For unmanaged devices, this value follows the format tpd_<mac>, where the mac address is used without colons
    - `mac` string: MAC address of the device
    - `name` string: Name of the device
    - `health` string: Health status of the device
    - `model` string: Model of the device
    - `deviceFunction` string: Device Function of the device
    - `deployment` string: Deployment type of the device
    - `status` string: Current status of the device
    - `type` string: Type of the device
    - `ipv4` string: IPv4 address of the device
    - `healthReason` string: Reason for the current health status
    - `conductorSerial` string: Serial number of the conductor (if applicable)
    - `internet` boolean: Indicates if the device has internet access
    - `lastSeen` number, float: Timestamp of the last time the device was seen
  - `links` Links
    - `from` string: Source device serial or identifier
    - `to` string: Destination device serial or identifier
    - `edgeType` string: Type of link between the devices
    - `health` string: Health status of the edge
    - `healthReason` string: Reason for edge health status
    - `speed` number, float: Speed of the connection in Gbps
    - `stpState` string: STP (Spanning Tree Protocol) state of the edge
    - `fromPortList` TopologyPort[]: List of ports on the source device involved in this edge
      - `index` integer: The index of the port
      - `name` string: The name of the port
      - `lag` string: LAG (Link Aggregation Group) name if applicable
      - `health` string: The health status of the port
      - `healthReason` string: The health reason of the port
    - `toPortList` TopologyPort[]: List of ports on the destination device involved in this edge
      - `index` integer: The index of the port
      - `name` string: The name of the port
      - `lag` string: LAG (Link Aggregation Group) name if applicable
      - `health` string: The health status of the port
      - `healthReason` string: The health reason of the port
    - `isSibling` boolean: Indicates if the edge connects sibling devices
  - `isolatedDevicesCount` integer: The number of isolated devices in the topology.
  - `isolatedHealth` string: Overall health status of isolated devices.

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