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

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

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

Returns information about the association between an Amazon Lex bot and a messaging platform.

This operation requires permissions for the `lex:GetBotChannelAssociation` action.

## Path parameters

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

## Response `200`

Success

- GetBotChannelAssociationResponse
  - `name` string — The name of the association between the bot and the channel.
  - `description` string — A description of the association between the bot and the channel.
  - `botAlias` string — An alias pointing to the specific version of the Amazon Lex bot to which this association is being made.
  - `botName` string — The name of the Amazon Lex bot.
  - `createdDate` string, date-time — The date that the association between the bot and the channel was created.
  - `type` 'Facebook' | 'Slack' | 'Twilio-Sms' | 'Kik' — The type of the messaging platform.
  - `botConfiguration` object — Provides information that the messaging platform needs to communicate with the Amazon Lex bot.
  - `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.

## Other responses

- `480` — NotFoundException
- `481` — LimitExceededException
- `482` — InternalFailureException
- `483` — 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)