# Get roles


**GET /_security/role/{name}**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_security/role</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_security/role/{name}</span>
                      </div>
                    

Get roles in the native realm.
The role management APIs are generally the preferred way to manage roles, rather than using file-based role management.
The get roles API cannot retrieve roles that are defined in roles files.

## Required authorization

* Cluster privileges: `read_security`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **name** (string | array[string])
  The name of the role.
  You can specify multiple roles as a comma-separated list.
  If you do not specify this parameter, the API returns information about all roles.



## Responses
### 200


#### Body: application/json (object)
- ***** (object)



[Powered by Bump.sh](https://bump.sh)