> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# outerbounds app list

## Usage

```bash theme={null}
outerbounds app list [OPTIONS]
```

## Description

Returns all deployments in the configured perimeter with their status and endpoint URLs.

## Options

Option

Default

Description

`--project`

Filter apps by project.

`--branch`

Filter apps by branch.

`--name`

Filter apps by name.

`--tag`

Filter apps by tag. Format `--tag <KEY>=<VALUE>`. Example `--tag foo=bar --tag x=y`. If multiple tags are provided, the app must match all of them. Repeatable.

`--format`

`text`

Format the output. Choices: `json`, `text`.

`--auth-type`

Filter apps by auth type. Choices: `Browser`, `API`, `BrowserAndApi`.

## Examples

**List everything in the perimeter**

```bash theme={null}
outerbounds app list
```

**Filter by project and branch**

```bash theme={null}
outerbounds app list --project my-project --branch main
```