New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Get token API Has privileges API »
Elastic Docs ›Elasticsearch Guide [7.2] ›X-Pack APIs ›Security APIs

Get users API

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Get users API

edit

Retrieves information about users in the native realm and built-in users.

Request

edit

GET /_security/user

GET /_security/user/<username>

Description

edit

For more information about the native realm, see Realms and Configuring a native realm.

Path Parameters

edit
username
(string) An identifier for the user. You can specify multiple usernames as a comma-separated list. If you omit this parameter, the API retrieves information about all users.

Authorization

edit

To use this API, you must have at least the manage_security cluster privilege.

Examples

edit

To retrieve a native user, submit a GET request to the /_security/user/<username> endpoint:

GET /_security/user/jacknich
Copy as curlTry in Elastic 

A successful call returns an array of users with the JSON representation of the user. Note that user passwords are not included.

{
  "jacknich": {
    "username": "jacknich",
    "roles": [
      "admin", "other_role1"
    ],
    "full_name": "Jack Nicholson",
    "email": "jacknich@example.com",
    "metadata": { "intelligence" : 7 },
    "enabled": true
  }
}
Copy as curlTry in Elastic 

If the user is not defined in the native realm, the request 404s.

Omit the username to retrieve all users:

GET /_security/user
Copy as curlTry in Elastic 
« Get token API Has privileges API »
Was this helpful?
Feedback