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

# GET /things

`GET /things`

Lists your things. Use the **attributeName** and **attributeValue** parameters to filter your things. For example, calling `ListThings` with attributeName=Color and attributeValue=Red retrieves all things in the registry that contain an attribute **Color** with the value **Red**. For more information, see [List Things](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html#list-things) from the _Amazon Web Services IoT Core Developer Guide_.

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

You will not be charged for calling this API if an `Access denied` error is returned. You will also not be charged if no attributes or pagination token was provided in request and no pagination token and no results were returned.

## Query parameters

- `nextToken` string
- `maxResults` integer
- `attributeName` string
- `attributeValue` string
- `thingTypeName` string
- `usePrefixAttributeValue` boolean

## Response `200`

Success

- ListThingsResponse — The output from the ListThings operation.
  - `things` ThingAttribute[] — The things.
    - `thingName` string — The name of the thing.
    - `thingTypeName` string — The name of the thing type, if the thing has been associated with a type.
    - `thingArn` string — The thing ARN.
    - `attributes` object — A list of thing attributes which are name-value pairs.
    - `version` integer — The version of the thing record in the registry.
  - `nextToken` string — The token to use to get the next set of results. Will not be returned if operation has returned all results.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — UnauthorizedException
- `483` — ServiceUnavailableException
- `484` — 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/revisions/deef5c4b09f0/schema)