---
title: "GET /managed-things"
method: GET
path: "/managed-things"
---

# GET /managed-things

`GET /managed-things`

Listing all managed things with provision for filters.

## Query parameters

- `OwnerFilter` string, password
- `CredentialLockerFilter` string
- `RoleFilter` 'CONTROLLER' | 'DEVICE'
- `ParentControllerIdentifierFilter` string
- `ConnectorPolicyIdFilter` string — ConnectorPolicyId is deprecated
- `ConnectorDestinationIdFilter` string
- `ConnectorDeviceIdFilter` string, password
- `SerialNumberFilter` string, password
- `ProvisioningStatusFilter` 'UNASSOCIATED' | 'PRE_ASSOCIATED' | 'DISCOVERED' | 'ACTIVATED' | 'DELETION_FAILED' | 'DELETE_IN_PROGRESS' | 'ISOLATED' | 'DELETED'
- `NextToken` string
- `MaxResults` integer

## Response `200`

Success

- ListManagedThingsResponse
  - `Items` ManagedThingSummary[] — The list of managed things.
    - `Id` string — The id of the device.
    - `Arn` string — The Amazon Resource Name (ARN) of the managed thing.
    - `AdvertisedProductId` string — The id of the advertised product.
    - `Brand` string, password — The brand of the device.
    - `Classification` string, password — The classification of the managed thing such as light bulb or thermostat.
    - `ConnectorDeviceId` string, password — <p>The third-party device id as defined by the connector. This device id must not contain personal identifiable information (PII).</p> <note> <p>This parameter is used for cloud-to-cloud devices only.</p> </note>
    - `ConnectorPolicyId` string — <p>The id of the connector policy.</p> <note> <p>This parameter is used for cloud-to-cloud devices only.</p> </note>ConnectorPolicyId has been deprecated
    - `ConnectorDestinationId` string — The identifier of the connector destination associated with this managed thing, if applicable.
    - `Model` string, password — The model of the device.
    - `Name` string — The name of the managed thing representing the physical device.
    - `Owner` string, password — Owner of the device, usually an indication of whom the device belongs to. This value should not contain personal identifiable information.
    - `CredentialLockerId` string — The identifier of the credential locker for the managed thing.
    - `ParentControllerId` string — Id of the controller device used for the discovery job.
    - `ProvisioningStatus` 'UNASSOCIATED' | 'PRE_ASSOCIATED' | 'DISCOVERED' | 'ACTIVATED' | 'DELETION_FAILED' | 'DELETE_IN_PROGRESS' | 'ISOLATED' | 'DELETED' — The provisioning status of the device in the provisioning workflow for onboarding to IoT managed integrations. For more information, see <a href="https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html">Device Provisioning</a>.
    - `Role` 'CONTROLLER' | 'DEVICE' — The type of device used. This will be the Amazon Web Services hub controller, cloud device, or IoT device.
    - `SerialNumber` string, password — The serial number of the device.
    - `CreatedAt` string, date-time — The timestamp value of when the device creation request occurred.
    - `UpdatedAt` string, date-time — The timestamp value of when the managed thing was last updated at.
    - `ActivatedAt` string, date-time — The timestampe value of when the managed thing was activated at.
  - `NextToken` string — A token that can be used to retrieve the next set of results.

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