---
title: "GET /thing-groups"
method: GET
path: "/thing-groups"
---

# GET /thing-groups

`GET /thing-groups`

List the thing groups in your account.

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

## Query parameters

- `nextToken` string
- `maxResults` integer
- `parentGroup` string
- `namePrefixFilter` string
- `recursive` boolean

## Response `200`

Success

- ListThingGroupsResponse
  - `thingGroups` GroupNameAndArn[] — The thing groups.
    - `groupName` string — The group name.
    - `groupArn` string — The group ARN.
  - `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` — InternalFailureException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException

---

[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)