---
title: "List Devices Pending Adoption"
method: GET
path: "/v1/pending-devices"
tags: ["UniFi Devices"]
---

# List Devices Pending Adoption

`GET /v1/pending-devices`

## 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/pending-devices`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubiquiti/apis/unifi-network-api/docs/v1/pending-devices/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of devices pending adoption, including basic device information.

<details>
<summary>Filterable properties (click to expand)</summary>

|Name|Type|Allowed functions|
|-|-|-|
|`macAddress`|`STRING`|`eq` `ne` `in` `notIn`|
|`ipAddress`|`STRING`|`eq` `ne` `in` `notIn`|
|`model`|`STRING`|`eq` `ne` `in` `notIn`|
|`state`|`STRING`|`eq` `ne` `in` `notIn`|
|`supported`|`BOOLEAN`|`eq` `ne`|
|`firmwareVersion`|`STRING`|`isNull` `isNotNull` `eq` `ne` `gt` `ge` `lt` `le` `like` `in` `notIn`|
|`firmwareUpdatable`|`BOOLEAN`|`eq` `ne`|
|`features`|`SET(STRING)`|`isEmpty` `contains` `containsAny` `containsAll` `containsExactly`|
</details>

## Query parameters

- `offset` integer
- `limit` integer
- `filter` string

## Response `200`

OK

- DevicePendingAdoptionPage
  - `offset` integer, required
  - `limit` integer, required
  - `count` integer, required
  - `totalCount` integer, required
  - `data` DevicePendingAdoption[], required
    - `macAddress` string, required
    - `ipAddress` string, required
    - `model` string, required
    - `state` 'ONLINE' | 'OFFLINE' | 'PENDING_ADOPTION' | 'UPDATING' | 'GETTING_READY' | 'ADOPTING' | 'DELETING' | 'CONNECTION_INTERRUPTED' | 'ISOLATED' | 'U5G_INCORRECT_TOPOLOGY', required
    - `supported` boolean, required
    - `firmwareVersion` string
    - `firmwareUpdatable` boolean, required
    - `features` string[], required
    - `adoptionTargetSiteIds` string[], required

---

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