---
title: "GET /things/{thingName}"
method: GET
path: "/things/{thingName}"
---

# GET /things/{thingName}

`GET /things/{thingName}`

Gets information about the specified thing.

Requires permission to access the [DescribeThing](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `thingName` string, required

## Response `200`

Success

- DescribeThingResponse — The output from the DescribeThing operation.
  - `defaultClientId` string — <p>The default MQTT client ID. For a typical device, the thing name is also used as the default MQTT client ID. Although we don’t require a mapping between a thing's registry name and its use of MQTT client IDs, certificates, or shadow state, we recommend that you choose a thing name and use it as the MQTT client ID for the registry and the Device Shadow service.</p> <p>This lets you better organize your IoT fleet without removing the flexibility of the underlying device certificate model or shadows.</p>
  - `thingName` string — The name of the thing.
  - `thingId` string — The ID of the thing to describe.
  - `thingArn` string — The ARN of the thing to describe.
  - `thingTypeName` string — The thing type name.
  - `attributes` object — The thing attributes.
  - `version` integer — <p>The current version of the thing record in the registry.</p> <note> <p>To avoid unintentional changes to the information in the registry, you can pass the version information in the <code>expectedVersion</code> parameter of the <code>UpdateThing</code> and <code>DeleteThing</code> calls.</p> </note>
  - `billingGroupName` string — The name of the billing group the thing belongs to.

## Other responses

- `480` — ResourceNotFoundException
- `481` — InvalidRequestException
- `482` — ThrottlingException
- `483` — UnauthorizedException
- `484` — ServiceUnavailableException
- `485` — InternalFailureException

---

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