---
title: "GET /accounts"
method: GET
path: "/accounts"
---

# GET /accounts

`GET /accounts`

Lists the Amazon Chime accounts under the administrator's AWS account. You can filter accounts by account name prefix. To find out which Amazon Chime account a user belongs to, you can filter by the user's email address, which returns one account result.

## Query parameters

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

## Response `200`

Success

- ListAccountsResponse
  - `Accounts` Account[] — List of Amazon Chime accounts and account details.
    - `AwsAccountId` string, required — The AWS account ID.
    - `AccountId` string, required — The Amazon Chime account ID.
    - `Name` string, required — The Amazon Chime account name.
    - `AccountType` 'Team' | 'EnterpriseDirectory' | 'EnterpriseLWA' | 'EnterpriseOIDC' — The Amazon Chime account type. For more information about different account types, see <a href="https://docs.aws.amazon.com/chime/latest/ag/manage-chime-account.html">Managing Your Amazon Chime Accounts</a> in the <i>Amazon Chime Administration Guide</i>.
    - `CreatedTimestamp` string, date-time — The Amazon Chime account creation timestamp, in ISO 8601 format.
    - `DefaultLicense` 'Basic' | 'Plus' | 'Pro' | 'ProTrial' — The default license for the Amazon Chime account.
    - `SupportedLicenses` License[] — Supported licenses for the Amazon Chime account.
    - `AccountStatus` 'Suspended' | 'Active' — The status of the account.
    - `SigninDelegateGroups` SigninDelegateGroup[] — The sign-in delegate groups associated with the account.
      - `GroupName` string — The group name.
  - `NextToken` string — The token to use to retrieve the next page of results.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — 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)