> ## 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.

# AppDeployer.list_deployments

```python theme={null}
AppDeployer.list_deployments(
    name: str = None,
    project: str = None,
    branch: str = None,
    tags: List[Dict[str, str]] = None
)
```

Lists deployed apps, optionally filtered by name, project, branch, or tags. This is a class method: call it directly on the class (`AppDeployer.list_deployments()`) without constructing an `AppDeployer` first.

**Parameters:**

**name** `string`

Filter by app name.

**project** `string`

Filter by project name.

**branch** `string`

Filter by branch name.

**tags** `object[]`

Filter by tags. Each tag is a dict with a single key-value pair, for example, `[{"env": "prod"}]` or `[{"team": "ml"}, {"version": "v2"}]`. Apps must have all specified tags to match.

**Returns:**

**value** `DeployedApp[]`

List of deployed apps matching the filters.

**Examples:**

**List all apps:**

```python theme={null}
apps = AppDeployer.list_deployments()
```

**Filter by name:**

```python theme={null}
apps = AppDeployer.list_deployments(name="my-app")
```

**Filter by project and branch:**

```python theme={null}
apps = AppDeployer.list_deployments(project="ml-pipeline", branch="main")
```

**Filter by a single tag:**

```python theme={null}
apps = AppDeployer.list_deployments(tags=[{"env": "prod"}])
```

**Filter by multiple tags (AND logic; the app must match all specified tags):**

```python theme={null}
apps = AppDeployer.list_deployments(tags=[{"env": "prod"}, {"team": "ml"}])
```

**Combine filters:**

```python theme={null}
apps = AppDeployer.list_deployments(
    project="recommendations",
    tags=[{"env": "staging"}]
)
```