---
title: "getPermissionList"
canonical: "https://support.appfire.com/space/JCLI/70785662/getPermissionList"
format: markdown
---
> Macro (aura-html)

See also: [Actions](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70787366)

> Macro (details)
> 
> | **Description** | Get a list of permissions for a permission scheme with regex filtering on holder name or value. Use the permission parameter to filter by permission type. If a permission scheme parameter is not provided, get a list of available permissions on the instance with regex filtering on permission key or name. Use @project for the permissionScheme parameter to use the permission scheme associated with the project identified by the project parameter. |
> | --- | --- |
> | **Required Parameters** |  |
> | **Optional Parameters** | [permissionScheme](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70785089), [project](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784165), [permission](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784201), [regex](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70789814), [limit](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70789871), [outputType](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784259), [file](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784297), [append](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70790085), [columns](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784781), [select](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70790299), [options](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70784233), [encoding](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70785169) |
> | **Type** | [Get](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70780909/Action+Types#ActionTypes-Get) |
> | **Category** | [Permissions](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70780591/Action+Categories#ActionCategories-Permissions) |
> | **Output Formats** |  |
> | **Replacement Variables** |  |
> | **Hosting** | cloud,server,datacenter |
> | **Since Version** | 8.8 |
> | **Examples** | [getPermissionList](https://appfire.atlassian.net/wiki/spaces/JCLI/pages/70782732/Examples#Examples-getPermissionList) |

## Related How To's

> Macro (cql-query)