> ## 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:**

<ParamField path="name" type="string">
  Filter by app name.
</ParamField>

<ParamField path="project" type="string">
  Filter by project name.
</ParamField>

<ParamField path="branch" type="string">
  Filter by branch name.
</ParamField>

<ParamField path="tags" type="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.
</ParamField>

**Returns:**

<ResponseField name="value" type="DeployedApp[]">
  List of deployed apps matching the filters.
</ResponseField>

**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"}]
)
```