---
title: "GET /app-instances"
method: GET
path: "/app-instances"
---

# GET /app-instances

`GET /app-instances`

Lists all Amazon Chime <code>AppInstance</code>s created under a single AWS account.

## Query parameters

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

## Response `200`

Success

- ListAppInstancesResponse
  - `AppInstances` AppInstanceSummary[] — The information for each <code>AppInstance</code>.
    - `AppInstanceArn` string — The <code>AppInstance</code> ARN.
    - `Name` string, password — The name of the <code>AppInstance</code>.
    - `Metadata` string, password — The metadata of the <code>AppInstance</code>.
  - `NextToken` string, password — The token passed by previous API requests until the maximum number of <code>AppInstance</code>s is reached.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — ThrottledClientException
- `483` — UnauthorizedClientException
- `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)