---
type: api
title: Fetch all users
description: Fetches all available users.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-get-users
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-get-users
products:
  - Elastic Cloud Enterprise
---

# Fetch all users

## Paths

- `GET` `/users`

- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/authentication#basicauth)
- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/authentication#apikey)

## Description

Fetches all available users.

## Query String Parameters

- `include_disabled` (boolean · default: false)
  True if disabled users should be included in the response

## Response

Users successfully fetched

`application/json`

- `users` ([] User)
  A list of users
  - `user_name` (string)
    The user's identifier
  - `security` ({} UserSecurity)
    A user's security information
    - `roles` ([] string)
      The set of roles assigned to a user
    - `permissions` ([] string)
      The distinct set of permissions allowed by the user's roles. These correspond to operationId values in the OpenAPI definition.
    - `elevated_permissions` ({} ElevatedPermissions)
      A user's elevated permissions status
      - `enabled` (boolean)
        True if the user has elevated permissions
      - `expires_at` (string)
        The time at which the user's elevated permissions expire
    - `password` (string)
      The user's password. Only used when modifying a user.
    - `enabled` (boolean)
      True if the user is enabled
    - `security_realm` ({} UserSecurityRealm)
      The security realm the user belongs to
      - `type` (enum)
        The type of the security realm
        Values: `native`, `ldap`, `saml`, `active_directory`
      - `id` (string)
        The identifier for the security realm
  - `metadata` ({} UserMetadata)
    Metadata for a user
    - `created_by` (string)
      The Id of the user that created this user
    - `created_at` (string)
      The date and time when the user was created
    - `updated_by` (string)
      The Id of the user that last updated this user
    - `updated_at` (string)
      The date and time when the user was last updated
    - `first_login_at` (string)
      The date and time when the user first logged in
    - `last_login_at` (string)
      The date and time when the user last logged in
  - `full_name` (string)
    The user's optional full name
  - `email` (string)
    The user's optional email address
  - `builtin` (boolean)
    True if the user is a built-in read-only user
## Code Examples

#### Console

```console
GET /users
```

#### curl

```curl
curl -X GET "/users"
```