# nsc artifact list

List artifacts in your workspace.

`artifact list` finds stored [artifacts](/content/docs/architecture/storage/artifact-storage.md).
Filter the results by artifact namespace, labels, or a regular expression matching the artifact path.

## Usage

```bash theme={null}
nsc artifact list [flags]
```

### Example

List artifacts whose paths begin with `build-outputs/`:

```bash theme={null}
nsc artifact list --match_path_regex '^build-outputs/' --output json
```

## Options

### --include_expired

Include expired entries in the results.

### --labels <key=value>

Only return artifacts with these labels. Accepts a `stringToString` map of key-value pairs, such as `--labels project=app,branch=main`. Defaults to an empty map (`[]`).

### --match_path_regex string

Only return artifacts whose path matches this regular expression.

### --max_entries int32

Maximum number of artifacts to return, up to `10000`. Defaults to `50`.

### --namespaces strings

Only return artifacts belonging to any of the specified namespaces.

### --output, -o <format>

Output format. One of `plain` or `json`. Defaults to `plain`.

## Related Topics

* [nsc artifact describe](/content/docs/reference/cli/artifact-describe.md) - Inspect an artifact's metadata
* [nsc artifact download](/content/docs/reference/cli/artifact-download.md) - Download an artifact
* [nsc artifact upload](/content/docs/reference/cli/artifact-upload.md) - Upload an artifact