Get service accounts

  • GET /_security/service/{namespace}/{service}
  • GET /_security/service/{namespace}
  • GET /_security/service
Api key auth Basic auth Bearer auth

Get a list of service accounts that match the provided path parameters. Built-in service accounts ship with Elasticsearch in the elastic namespace; user-managed service accounts are created with the put user-managed service account API.

NOTE: When type is omitted, a request without a namespace reports built-in accounts only, which preserves the response of a whole-cluster listing. A request scoped to a namespace reports both kinds, so an account you created is found without naming its kind.

Required authorization

  • Cluster privileges: manage_service_account
More about service accounts

Query Parameters

type union ServiceAccountType | [] ServiceAccountType

A comma-separated list of the kinds of service account to return. If it is omitted, it defaults to built_in when no namespace is given and to built_in,user_managed otherwise.

Supported values include:

  • built_in: An account that ships with Elasticsearch, in the reserved elastic namespace.
  • user_managed: An account created with the put user-managed service account API.
Values: built_in user_managed

Response