Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

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 from the Amazon Web Services IoT Core Developer Guide.

Requires permission to access the ListThings 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.

get/things

Query parameters

nextTokenstring

To retrieve the next set of results, the <code>nextToken</code> value from a previous response; otherwise <b>null</b> to receive the first set of results.

maxResultsinteger

The maximum number of results to return in this operation.

attributeNamestring

The attribute name used to search for things.

attributeValuestring

The attribute value used to search for things.

thingTypeNamestring

The name of the thing type used to search for things.

usePrefixAttributeValueboolean
<p>When <code>true</code>, the action returns the thing resources with attribute values that start with the <code>attributeValue</code> provided.</p> <p>When <code>false</code>, or not present, the action returns only the thing resources with attribute values that match the entire <code>attributeValue</code> provided. </p>

Response

Success

nextTokenstring

The token to use to get the next set of results. Will not be returned if operation has returned all results.