---
title: "GET /device-discoveries"
method: GET
path: "/device-discoveries"
---

# GET /device-discoveries

`GET /device-discoveries`

Lists all device discovery tasks, with optional filtering by type and status.

## Query parameters

- `NextToken` string
- `MaxResults` integer
- `TypeFilter` 'ZWAVE' | 'ZIGBEE' | 'CLOUD' | 'CUSTOM' | 'CONTROLLER_CAPABILITY_REDISCOVERY'
- `StatusFilter` 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT'

## Response `200`

Success

- ListDeviceDiscoveriesResponse
  - `Items` DeviceDiscoverySummary[] — The list of device discovery jobs that match the specified criteria.
    - `Id` string — The unique identifier of the device discovery job.
    - `DiscoveryType` 'ZWAVE' | 'ZIGBEE' | 'CLOUD' | 'CUSTOM' | 'CONTROLLER_CAPABILITY_REDISCOVERY' — The type of discovery process used to find devices.
    - `Status` 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT' — The current status of the device discovery job.
  - `NextToken` string — A token used for pagination of results when there are more device discovery jobs than can be returned in a single response.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — UnauthorizedException
- `484` — ServiceUnavailableException
- `485` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iot-managed-integrations.md) · [All operations](https://skmtc.net/aws/apis/iot-managed-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot-managed-integrations/versions/d043c13c812a/schema)