---
title: "GET /channels#app-instance-arn&x-amz-chime-bearer"
method: GET
path: "/channels#app-instance-arn&x-amz-chime-bearer"
---

# GET /channels#app-instance-arn&x-amz-chime-bearer

`GET /channels#app-instance-arn&x-amz-chime-bearer`

Lists all Channels created under a single Chime App as a paginated list. You can specify filters to narrow results.

**Functionality & restrictions**

*   Use privacy = `PUBLIC` to retrieve all public channels in the account.
    
*   Only an `AppInstanceAdmin` can set privacy = `PRIVATE` to list the private channels in an account.
    

The `x-amz-chime-bearer` request header is mandatory. Use the ARN of the `AppInstanceUser` or `AppInstanceBot` that makes the API call as the value in the header.

## Query parameters

- `app-instance-arn` string, required
- `privacy` 'PUBLIC' | 'PRIVATE'
- `max-results` integer
- `next-token` string, password

## Headers

- `x-amz-chime-bearer` string, required

## Response `200`

Success

- ListChannelsResponse
  - `Channels` ChannelSummary[] — The information about each channel.
    - `Name` string, password — The name of the channel.
    - `ChannelArn` string — The ARN of the channel.
    - `Mode` 'UNRESTRICTED' | 'RESTRICTED' — The mode of the channel.
    - `Privacy` 'PUBLIC' | 'PRIVATE' — The privacy setting of the channel.
    - `Metadata` string, password — The metadata of the channel.
    - `LastMessageTimestamp` string, date-time — The time at which the last persistent message visible to the caller in a channel was sent.
  - `NextToken` string, password — The token returned from previous API requests until the number of channels is reached.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — UnauthorizedClientException
- `483` — ThrottledClientException
- `484` — ServiceUnavailableException
- `485` — ServiceFailureException

---

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