---
title: "List users"
method: GET
path: "/groups/{groupId}/apps/{appId}/users"
tags: ["users"]
---

# List users

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

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

## Query parameters

- `after` string
- `sort` string
- `desc` boolean

## Response `200`

Successfully listed.

- User[] — At most 50 results per request.
  - `_id` string — The unique user account ID
  - `identities` UserIdentity[] — A list of authentication provider identities associated with the user account.
    - `id` string
    - `provider_type` 'anon-user' | 'local-userpass' | 'api-key' | 'oauth2-apple' | 'oauth2-google' | 'oauth2-facebook' | 'custom-token' | 'custom-function'
    - `provider_id` string
  - `type` 'normal' | 'server' — 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`.

---

[API](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api.md) · [All operations](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mongodb/mongodb-atlas-app-services-admin-api/versions/1365ab72bc03/schema)