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

# GET /channels

`GET /channels`

Retrieves a list of channels.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListChannelsResponse
  - `channelSummaries` ChannelSummary[] — A list of <code>ChannelSummary</code> objects.
    - `channelName` string — The name of the channel.
    - `channelStorage` object — Where channel data is stored.
      - `serviceManagedS3` object — Used to store channel data in an S3 bucket managed by IoT Analytics.
      - `customerManagedS3` object — Used to store channel data in an S3 bucket that you manage.
        - `bucket` string — The name of the S3 bucket in which channel data is stored.
        - `keyPrefix` string — (Optional) The prefix used to create the keys of the channel data objects. Each object in an S3 bucket has a key that is its unique identifier within the bucket (each object in a bucket has exactly one key). The prefix must end with a forward slash (/).
        - `roleArn` string — The ARN of the role that grants IoT Analytics permission to interact with your Amazon S3 resources.
    - `status` 'CREATING' | 'ACTIVE' | 'DELETING' — The status of the channel.
    - `creationTime` string, date-time — When the channel was created.
    - `lastUpdateTime` string, date-time — The last time the channel was updated.
    - `lastMessageArrivalTime` string, date-time — <p>The last time when a new message arrived in the channel.</p> <p>IoT Analytics updates this value at most once per minute for one channel. Hence, the <code>lastMessageArrivalTime</code> value is an approximation.</p> <p>This feature only applies to messages that arrived in the data store after October 23, 2020. </p>
  - `nextToken` string — The token to retrieve the next set of results, or <code>null</code> if there are no more results.

## Other responses

- `480` — InvalidRequestException
- `481` — InternalFailureException
- `482` — ServiceUnavailableException
- `483` — ThrottlingException

---

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