---
title: "Get Adopted Device Details"
method: GET
path: "/v1/sites/{siteId}/devices/{deviceId}"
tags: ["UniFi Devices"]
---

# Get Adopted Device Details

`GET /v1/sites/{siteId}/devices/{deviceId}`

## Request

- Base URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/network/integration`
- URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/network/integration/v1/sites/{siteId}/devices/{deviceId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubiquiti/apis/unifi-network-api/docs/v1/sites/:siteId/devices/:deviceId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve detailed information about a specific adopted device, including firmware versioning, uplink state, details about device features and interfaces (ports, radios) and other key attributes.

## Path parameters

- `siteId` string, uuid, required
- `deviceId` string, uuid, required

## Response `200`

OK

- AdoptedDeviceDetails
  - `id` string, uuid, required
  - `macAddress` string, required
  - `ipAddress` string, required
  - `name` string, required
  - `model` string, required
  - `supported` boolean, required
  - `state` 'ONLINE' | 'OFFLINE' | 'PENDING_ADOPTION' | 'UPDATING' | 'GETTING_READY' | 'ADOPTING' | 'DELETING' | 'CONNECTION_INTERRUPTED' | 'ISOLATED' | 'U5G_INCORRECT_TOPOLOGY', required
  - `firmwareVersion` string
  - `firmwareUpdatable` boolean, required
  - `adoptedAt` string, date-time
  - `provisionedAt` string, date-time
  - `configurationId` string, required
  - `uplink` DeviceUplinkInterfaceOverview: Uplink interface is device's connection to the parent device in the network topology
    - `deviceId` string, uuid, required
  - `features` DeviceFeatures, required
    - `switching` unknown
    - `accessPoint` unknown
  - `interfaces` DevicePhysicalInterfaces, required
    - `ports` PortOverview[]
      - `idx` integer, required
      - `state` 'UP' | 'DOWN' | 'UNKNOWN', required
      - `connector` 'RJ45' | 'SFP' | 'SFPPLUS' | 'SFP28' | 'QSFP28', required
      - `maxSpeedMbps` integer, required
      - `speedMbps` integer
      - `poe` PortPoEOverview
        - `standard` '802.3af' | '802.3at' | '802.3bt', required
        - `type` integer, required
        - `enabled` boolean, required: Whether the PoE feature is enabled on the port
        - `state` 'UP' | 'DOWN' | 'LIMITED' | 'UNKNOWN', required: Whether the port currently supplies power to the (connected) device.
    - `radios` WirelessRadioOverview[]
      - `wlanStandard` '802.11a' | '802.11b' | '802.11g' | '802.11n' | '802.11ac' | '802.11ax' | '802.11be', required
      - `frequencyGHz` 2.4 | 5 | 6 | 60, required
      - `channelWidthMHz` integer, required
      - `channel` integer

---

[API](https://skmtc.dev/ubiquiti/apis/unifi-network-api.md) - [All operations](https://skmtc.dev/ubiquiti/apis/unifi-network-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ubiquiti/apis/unifi-network-api/revisions/822d5af98ce5?raw)