---
title: "Returns details for an unmanaged device of a given site."
method: GET
path: "/network-monitoring/v1/unmanaged-device/{mac-address}"
tags: ["Topology"]
---

# Returns details for an unmanaged device of a given site.

`GET /network-monitoring/v1/unmanaged-device/{mac-address}`

## Request

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

This API provides unmanaged device details for a specific site and device mac

## Path parameters

- `mac-address` string, const, required: The device mac address.

## Query parameters

- `site-id` string, const, required

## Response `200`

Success

- UnmanagedDevice: Unmanaged device details for a given site
  - `id` string, required: Primary identifier for the resource.
  - `name` string: Name of the unmanaged device
  - `serial` string: This value follows the format tpd_<mac>, where the mac address is used without colons
  - `type` string, required: Device type, e.g., Switch, Router, Access Point
  - `mac` string: MAC address of the device
  - `supportedCapability` string: Capabilities supported by the device
  - `enabledCapability` string: Capabilities currently enabled on the device.
  - `description` string: Additional description or notes about the device
  - `vendor` string: Vendor or manufacturer of the device
  - `status` string: Operational status of the device

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