# Retrieve a Role's Permissions

`GET /lokta-lms/api/v1/roles/{roleId}/permissions`

Example Requests:

roles/1/permissions

## Parameters
- `roleId` (path, integer, required): roleId

## Responses
- `200`: OK

## Response fields
- `description` (string)
- `id` (integer)
- `name` (string)
- `permissionUsageData` (array of GetRolesRoleIdPermissionsResponsePermissionData)

## Example request (cURL)
```bash
curl -X GET \
  'http://localhost:8080/lokta-lms/api/v1/roles/{roleId}/permissions' \
  -u '{username}:{password}' \
  -H 'Tenant-Identifier: default'
```

## Example response
```json
{
  "description": "This role provides all application permissions.",
  "id": 1,
  "name": "Super Users",
  "permissionUsageData": [
    {}
  ]
}
```

Interactive: https://developer.lokta.ai/reference.html#operation/retrieveRolePermissions