# List users

**GET /groups/{groupId}/apps/{appId}/users**

List confirmed [user accounts](https://www.mongodb.com/zh-cn/docs/atlas/app-services/authentication#std-label-user-accounts).


## Servers
- The root API resource and starting point for the App Services API.: https://services.cloud.mongodb.com/api/admin/v3.0 (The root API resource and starting point for the App Services API.)


## Authentication methods
- Token auth


## Parameters

### Path parameters
- **groupId** (string)
  An Atlas [Project/Group
  ID](https://docs.atlas.mongodb.com/tutorial/manage-projects/).
- **appId** (string)
  The ObjectID of your application.
  [The App Services API Project and Application IDs section](#section/Project-and-Application-IDs) demonstrates how to find this
  value.

### Query parameters
- **after** (string)
  The `id` of the last user returned by a previous paginated request.
- **sort** (string)
  The field name to sort results by. The only valid value is the
  default: `_id`.
- **desc** (boolean)
  If `true`, returns sorted results in descending order. If not specified
  or set to `false`, results return in ascending order.


## Responses
### 200
Successfully listed.

#### Body: application/json (array[object])
- **_id** (string)
  The unique user account ID
- **identities** (array[object])
  A list of authentication provider identities associated with the user account.
- **type** (string)
  The user type. Most users are `normal` and represent a
  specific human user. Users created through the `api-key`
  provider have the type `server` because they are typically
  used for programmatic access from a server.
- **creation_date** (integer)
  The date and time that the user account was created.
  Represented by the number of seconds since the UNIX epoch.
- **last_authentication_date** (integer)
  The date and time that the user account last logged in or
  authenticated a request. Represented by the number of
  seconds since the UNIX epoch.
- **disabled** (boolean)
  If `true`, the user account is inactive and cannot login or interact with App Services.
- **data** (object)
  Metadata that describes the user. This field combines the
  data for all authentication identities associated with the
  user. The exact field names and values depend on which
  authentication providers the user has authenticated with.

  For example, if a user has linked an email/password account
  with their Google account, this object might contain their
  `email` as well as metadata fields from Google like `name`
  and `picture`.


[Powered by Bump.sh](https://bump.sh)