---
title: "GET /bots/{botName}/aliases/{aliasName}/channels/"
method: GET
path: "/bots/{botName}/aliases/{aliasName}/channels/"
---

# GET /bots/{botName}/aliases/{aliasName}/channels/

`GET /bots/{botName}/aliases/{aliasName}/channels/`

Returns a list of all of the channels associated with the specified bot.

The `GetBotChannelAssociations` operation requires permissions for the `lex:GetBotChannelAssociations` action.

## Path parameters

- `botName` string, required
- `aliasName` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer
- `nameContains` string

## Response `200`

Success

- GetBotChannelAssociationsResponse
  - `botChannelAssociations` BotChannelAssociation[] — An array of objects, one for each association, that provides information about the Amazon Lex bot and its association with the channel.
    - `name` string — The name of the association between the bot and the channel.
    - `description` string — A text description of the association you are creating.
    - `botAlias` string — An alias pointing to the specific version of the Amazon Lex bot to which this association is being made.
    - `botName` string — <p>The name of the Amazon Lex bot to which this association is being made. </p> <note> <p>Currently, Amazon Lex supports associations with Facebook and Slack, and Twilio.</p> </note>
    - `createdDate` string, date-time — The date that the association between the Amazon Lex bot and the channel was created.
    - `type` 'Facebook' | 'Slack' | 'Twilio-Sms' | 'Kik' — Specifies the type of association by indicating the type of channel being established between the Amazon Lex bot and the external messaging platform.
    - `botConfiguration` object — Provides information necessary to communicate with the messaging platform.
    - `status` 'IN_PROGRESS' | 'CREATED' | 'FAILED' — <p>The status of the bot channel. </p> <ul> <li> <p> <code>CREATED</code> - The channel has been created and is ready for use.</p> </li> <li> <p> <code>IN_PROGRESS</code> - Channel creation is in progress.</p> </li> <li> <p> <code>FAILED</code> - There was an error creating the channel. For information about the reason for the failure, see the <code>failureReason</code> field.</p> </li> </ul>
    - `failureReason` string — If <code>status</code> is <code>FAILED</code>, Amazon Lex provides the reason that it failed to create the association.
  - `nextToken` string — A pagination token that fetches the next page of associations. If the response to this call is truncated, Amazon Lex returns a pagination token in the response. To fetch the next page of associations, specify the pagination token in the next request.

## Other responses

- `480` — LimitExceededException
- `481` — InternalFailureException
- `482` — BadRequestException

---

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