---
title: "GET /channels/{channelArn}/bans"
method: GET
path: "/channels/{channelArn}/bans"
---

# GET /channels/{channelArn}/bans

`GET /channels/{channelArn}/bans`

Lists all the users banned from a particular channel.

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.

## Path parameters

- `channelArn` string, required

## Query parameters

- `max-results` integer
- `next-token` string, password
- `MaxResults` string
- `NextToken` string

## Headers

- `x-amz-chime-bearer` string

## Response `200`

Success

- ListChannelBansResponse
  - `ChannelArn` string — The ARN of the channel.
  - `NextToken` string, password — The token passed by previous API calls until all requested bans are returned.
  - `ChannelBans` ChannelBanSummary[] — The information for each requested ban.
    - `Member` object — The member being banned from a channel.
      - `Arn` string — The ARN in an Identity.
      - `Name` string, password — The name in an Identity.

## Other responses

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

---

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