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

# GET /accounts/{accountId}/users

`GET /accounts/{accountId}/users`

Lists the users that belong to the specified Amazon Chime account. You can specify an email address to list only the user that the email address belongs to.

## Path parameters

- `accountId` string, required

## Query parameters

- `user-email` string, password
- `user-type` 'PrivateUser' | 'SharedDevice'
- `max-results` integer
- `next-token` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListUsersResponse
  - `Users` User[] — List of users and user details.
    - `UserId` string, required — The user ID.
    - `AccountId` string — The Amazon Chime account ID.
    - `PrimaryEmail` string, password — The primary email address of the user.
    - `PrimaryProvisionedNumber` string, password — The primary phone number associated with the user.
    - `DisplayName` string, password — The display name of the user.
    - `LicenseType` 'Basic' | 'Plus' | 'Pro' | 'ProTrial' — The license type for the user.
    - `UserType` 'PrivateUser' | 'SharedDevice' — The user type.
    - `UserRegistrationStatus` 'Unregistered' | 'Registered' | 'Suspended' — The user registration status.
    - `UserInvitationStatus` 'Pending' | 'Accepted' | 'Failed' — The user invite status.
    - `RegisteredOn` string, date-time — Date and time when the user is registered, in ISO 8601 format.
    - `InvitedOn` string, date-time — Date and time when the user is invited to the Amazon Chime account, in ISO 8601 format.
    - `AlexaForBusinessMetadata` object — The Alexa for Business metadata.
      - `IsAlexaForBusinessEnabled` boolean — Starts or stops Alexa for Business.
      - `AlexaForBusinessRoomArn` string, password — The ARN of the room resource.
    - `PersonalPIN` string — The user's personal meeting PIN.
  - `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)