---
title: "GET /device-discoveries/{Identifier}"
method: GET
path: "/device-discoveries/{Identifier}"
---

# GET /device-discoveries/{Identifier}

`GET /device-discoveries/{Identifier}`

Get the current state of a device discovery.

## Path parameters

- `Identifier` string, required

## Response `200`

Success

- GetDeviceDiscoveryResponse
  - `Id` string, required — The id of the device discovery job request.
  - `Arn` string, required — The Amazon Resource Name (ARN) of the device discovery job request.
  - `DiscoveryType` 'ZWAVE' | 'ZIGBEE' | 'CLOUD' | 'CUSTOM' | 'CONTROLLER_CAPABILITY_REDISCOVERY', required — The discovery type supporting the type of device to be discovered in the device discovery job request.
  - `Status` 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT', required — The status of the device discovery job request.
  - `StartedAt` string, date-time, required — The timestamp value for the start time of the device discovery.
  - `ControllerId` string — The id of the end-user's IoT hub.
  - `ConnectorAssociationId` string — The ID tracking the current discovery process for one connector association.ConnectorAssociationId has been deprecated
  - `AccountAssociationId` string — The identifier of the account association used for the device discovery.
  - `FinishedAt` string, date-time — The timestamp value for the completion time of the device discovery.
  - `Tags` object — A set of key/value pairs that are used to manage the device discovery request.Tags have been deprecated from this api

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — UnauthorizedException
- `484` — ServiceUnavailableException
- `485` — ResourceNotFoundException
- `486` — 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)