---
title: kapacitor flux task run list
description: The kapacitor flux task run list command lists runs Kapacitor Flux task.
url: https://docs.influxdata.com/kapacitor/v1/reference/cli/kapacitor/flux/task/run/list/
estimated_tokens: 536
product: Kapacitor
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/kapacitor/v1/reference/cli/kapacitor/flux/task/run/list/
date: '2023-10-03T10:49:57-06:00'
lastmod: '2023-10-03T10:49:57-06:00'
---

The `kapacitor flux task run list` command lists runs Kapacitor Flux task.

## Usage

```sh
kapacitor flux task run list [flags]
```

#### Aliases

* `find`
* `ls`

## Flags

|Flag|           |                          Description                           |
|----|-----------|----------------------------------------------------------------|
|    | `--json`  |                      Output data as JSON                       |
|    |`--task-id`|                     Required: Flux task ID                     |
|    |`--run-id` |                          Task run ID                           |
|    |`--before` |Output runs that executed before this time *(RFC3339 timestamp)*|
|    | `--after` |Output runs that executed after this time *(RFC3339 timestamp)* |
|    | `--limit` |              Limit the results *(default is 100)*              |
|`-h`| `--help`  |                       Show command help                        |

## Examples

* [List runs for a Flux task](#list-runs-for-a-flux-task)
* [List Flux task runs that occurred in a time range](#list-flux-task-runs-that-occurred-in-a-time-range)
* [List a limited number of Flux task runs](#list-a-limited-number-of-flux-task-runs)

### List runs for a Flux task

```sh
kapacitor flux task run list --task-id 000x00xX0xXXx00
```

### List Flux task runs that occurred in a time range

```sh
kapacitor flux task run list \
  --task-id 000x00xX0xXXx00 \
  --after 2021-01-01T00:00:00Z \
  --before 2021-01-31T00:00:00Z
```

### List a limited number of Flux task runs

```sh
kapacitor flux task run list \
  --task-id 000x00xX0xXXx00 \
  --limit 10
```

#### Related

* [Manage Kapacitor Flux task runs](/kapacitor/v1/working/flux/manage/task-runs/)
| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
|  | --json | Output data as JSON |
|  | --task-id | Required : Flux task ID |
|  | --run-id | Task run ID |
|  | --before | Output runs that executed before this time  (RFC3339 timestamp) |
|  | --after | Output runs that executed after this time  (RFC3339 timestamp) |
|  | --limit | Limit the results  (default is 100) |
| -h | --help | Show command help |