---
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}`

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