v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14191644620.9 KB

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 AppInstanceUserArn of the user that makes the API call as the value in the header.

get/channels#app-instance-arn

Query parameters

app-instance-arnstring required

The ARN of the <code>AppInstance</code>.

privacy'PUBLIC' | 'PRIVATE'

The privacy setting. <code>PUBLIC</code> retrieves all the public channels. <code>PRIVATE</code> retrieves private channels. Only an <code>AppInstanceAdmin</code> can retrieve private channels.

max-resultsinteger

The maximum number of channels that you want to return.

next-tokenstring password

The token passed by previous API calls until all requested channels are returned.

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Headers

x-amz-chime-bearerstring

The <code>AppInstanceUserArn</code> of the user that makes the API call.

Response

Success

NextTokenstring password

The token returned from previous API requests until the number of channels is reached.