---
title: "getRunnerList"
canonical: "https://support.appfire.com/space/BCCLI/65766639/getRunnerList"
format: markdown
---
> Macro (aura-html)

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

> Macro (details)
> 
> | **Description** | Get list of pipeline runners for a workspace or a repository or both. Note that @all can be specified for the repository parameter to get runner information across all repositories in a workspace or all authorized. |
> | --- | --- |
> | **Required Parameters** | [workspace](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65765634) or [repository](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766277) |
> | **Optional Parameters** | [outputFormat](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65765525), [regex](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65767227), [columns](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766357), [select](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65768292), [options](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65767811), [outputType](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65768516), [file](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65768095), [encoding](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766303), [append](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65765977) |
> | **Type** | [Get](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65768932/Action+Types#ActionTypes-Get) |
> | **Category** | [Pipelines](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766329/Action+Categories#ActionCategories-Pipelines) |
> | **Output Formats** | , , 2 - add active pipeline step information, |
> | **Replacement Variables** |  |
> | **Since Version** | 10.0 |
> | **Examples** | [getRunnerList](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766633/Examples#getRunnerList) |

## Related How To's

> Macro (cql-query)