---
title: "GET /managed-thing-states/{ManagedThingId}"
method: GET
path: "/managed-thing-states/{ManagedThingId}"
---

# GET /managed-thing-states/{ManagedThingId}

`GET /managed-thing-states/{ManagedThingId}`

Returns the managed thing state for the given device Id.

## Path parameters

- `ManagedThingId` string, required

## Response `200`

Success

- GetManagedThingStateResponse
  - `Endpoints` StateEndpoint[], required — The device endpoint.
    - `endpointId` string, required — Numeric identifier of the endpoint
    - `capabilities` StateCapability[], required — Describe the endpoint with an id, a name, and the relevant capabilities for the reporting state.
      - `id` string, required — The id of the managed thing in the capability report.
      - `name` string, required — Name for the Amazon Web Services capability.
      - `version` string, required — Version for the Amazon Web Services capability.
      - `properties` unknown

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InternalFailureException
- `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)