GET

/thing-groups/{thingGroupName}/things

http://iot.{region}.amazonaws.com/thing-groups/{thingGroupName}/things

Lists the things in the specified group. Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions">ListThingsInThingGroup</a> action.

Access Token Required: API Key

Path Parameters

thingGroupNamestringrequired

The thing group name.

Query Params

recursiveboolean

When true, list things in this thing group and in all child groups as well.

nextTokenstring

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

maxResultsinteger

The maximum number of results to return at one time.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://iot.{region}.amazonaws.com/thing-groups/{thingGroupName}/things' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}