---
title: "GET /accounts/{accountId}/bots"
method: GET
path: "/accounts/{accountId}/bots"
---

# GET /accounts/{accountId}/bots

`GET /accounts/{accountId}/bots`

Lists the bots associated with the administrator's Amazon Chime Enterprise account ID.

## Path parameters

- `accountId` string, required

## Query parameters

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

## Response `200`

Success

- ListBotsResponse
  - `Bots` Bot[] — List of bots and bot details.
    - `BotId` string — The bot ID.
    - `UserId` string — The unique ID for the bot user.
    - `DisplayName` string, password — The bot display name.
    - `BotType` 'ChatBot' — The bot type.
    - `Disabled` boolean — When true, the bot is stopped from running in your account.
    - `CreatedTimestamp` string, date-time — The bot creation timestamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The updated bot timestamp, in ISO 8601 format.
    - `BotEmail` string, password — The bot email address.
    - `SecurityToken` string, password — The security token used to authenticate Amazon Chime with the outgoing event endpoint.
  - `NextToken` string — The token to use to retrieve the next page of results.

## Other responses

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

---

[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/revisions/40da18840201/schema)