---
type: api
title: Get all roles
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-security-role
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-get-security-role
products:
  - Kibana
---

# Get all roles

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/security/role`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v8/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/kibana/v8/authentication#basicauth)

## Query String Parameters

- `replaceDeprecatedPrivileges` (boolean)
  If `true` and the response contains any privileges that are associated with deprecated features, they are omitted in favor of details about the appropriate replacement feature privileges.

## Response

Indicates a successful call.

## Code Examples

#### Console

```console
GET /api/security/role
```

#### curl

```curl
curl -X GET "https://{kibana_url}/api/security/role"
```

## Response Examples

#### Get all role details

```json
[
  {
    "name": "my_kibana_role",
    "description": "My kibana role description",
    "metadata": {
      "version": 1
    },
    "transient_metadata": {
      "enabled": true
    },
    "elasticsearch": {
      "indices": [],
      "cluster": [],
      "run_as": []
    },
    "kibana": [
      {
        "base": [
          "all"
        ],
        "feature": {},
        "spaces": [
          "*"
        ]
      }
    ]
  },
  {
    "name": "my_admin_role",
    "description": "My admin role description",
    "metadata": {
      "version": 1
    },
    "transient_metadata": {
      "enabled": true
    },
    "elasticsearch": {
      "cluster": [
        "all"
      ],
      "indices": [
        {
          "names": [
            "index1",
            "index2"
          ],
          "privileges": [
            "all"
          ],
          "field_security": {
            "grant": [
              "title",
              "body"
            ]
          },
          "query": "{\\\u0022match\\\u0022: {\\\u0022title\\\u0022: \\\u0022foo\\\u0022}}"
        }
      ]
    },
    "kibana": []
  }
]
```