---
title: "getProjectList"
canonical: "https://support.appfire.com/space/SCLI/73368944/getProjectList"
format: markdown
---
See also: [Actions](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73368507)

> Macro (details)
> 
> | **Description** | Get a list of projects based on the selection criteria. Option to restrict to projects with a specific permission. Regex matching on project key or name. |
> | --- | --- |
> | **Required Parameters** |  |
> | **Optional Parameters** | [permission](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73368785), [regex](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73371597), [limit](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73371427), [columns](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73371162), [select](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73368976), [options](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73371383), [outputType](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73368777), [file](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73370741), [encoding](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73368755), [append](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73370891) |
> | **Type** | [Get](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73370540/Action+Types#ActionTypes-Get) |
> | **Category** | [Projects](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73371318/Action+Categories#ActionCategories-Projects) |
> | **Output Formats** | 1 - basic, 999 - all including default permission |
> | **Replacement Variables** |  |
> | **Hosting** | server,datacenter |
> | **Since Version** |  |
> | **Examples** | [getProjectList](https://appfire.atlassian.net/wiki/spaces/SCLI/pages/73371753/Examples#Examples-getProjectList) |

## Related How To's

> Macro (cql-query)