---
type: api
title: List security realm configurations
description: Retrieves a list of security realm configurations.
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v4/operation/operation-get-security-realm-configurations
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v4/operation/operation-get-security-realm-configurations
products:
  - Elastic Cloud Enterprise
---

# List security realm configurations

Authentication: required

## Paths

- `GET` `/platform/configuration/security/realms`

## Description

Retrieves a list of security realm configurations.

## Response

The security realm configurations were successfully returned

`application/json`

- `realms` (object[])
  The list of security realms
  - `id` (string)
    The identifier for the security realm
  - `name` (string)
    The friendly name of the security realm
  - `type` (enum)
    The type of the security realm
    Values: `native`, `ldap`, `saml`, `active_directory`
  - `enabled` (boolean)
    True if the security realm is enabled
  - `order` (integer · format: int32)
    The order the security realm should be evaluated
  - `urls` (string[])
    The URLs associated with the security realm
## Code examples

#### curl

```curl
curl -X GET "${API_URL}/platform/configuration/security/realms" \
  -u "${USERNAME}:${PASSWORD}"
```

## Response examples

#### 200

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "realms": [
    {
      "id": "string",
      "name": "string",
      "type": "native",
      "enabled": false,
      "order": 0,
      "urls": [
        "string"
      ]
    }
  ]
}
```