---
title: "GET /app-instance-bots#app-instance-arn"
method: GET
path: "/app-instance-bots#app-instance-arn"
---

# GET /app-instance-bots#app-instance-arn

`GET /app-instance-bots#app-instance-arn`

Lists all <code>AppInstanceBots</code> created under a single <code>AppInstance</code>.

## Query parameters

- `app-instance-arn` string, required
- `max-results` integer
- `next-token` string, password

## Response `200`

Success

- ListAppInstanceBotsResponse
  - `AppInstanceArn` string — The ARN of the AppInstance.
  - `AppInstanceBots` AppInstanceBotSummary[] — The information for each requested <code>AppInstanceBot</code>.
    - `AppInstanceBotArn` string — The ARN of the AppInstanceBot.
    - `Name` string, password — The name of the AppInstanceBox.
    - `Metadata` string, password — The metadata of the AppInstanceBot.
  - `NextToken` string, password — The token passed by previous API calls until all requested bots are returned.

## Other responses

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

---

[API](https://skmtc.net/aws/apis/chime-sdk-identity.md) · [All operations](https://skmtc.net/aws/apis/chime-sdk-identity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime-sdk-identity/revisions/5ac0320cd9af/schema)