list-runs

Elena Kostyuchenko

Definition

Displays information about DAG runs for the specified DAG ID.

Usage

$ airflow dags list-runs [-h] -d DAG_ID [-e END_DATE] [--no-backfill]
                       [-o table, json, yaml, plain] [-s START_DATE]
                       [--state queued, running, success, failed] [-v]

Arguments

Parameter Description

-d, --dag-id

The ID of the DAG

-s, --start-date

If start_date is provided, all the DAG runs that were executed before this date will be filtered out

-e, --end-date

If end_date is provided, all the DAG runs that were executed after this date will be filtered out

--no-backfill

If no_backfill option is used, all backfill DAG runs for given DAG ID will be filtered out

--state

If state option is used, only the DAG runs with the given state will be searched for. Possible values: queued, running, success, failed

-h, --help

Print out the help manual for this command

-v, --verbose

Make logging output more verbose

-y, --yes

Do not prompt for confirmation

Examples

The following command displays information about the running DAGs with the example_complex ID:

$ airflow dags list-runs -d example_complex --state running

Output example:

dag_id          | run_id                      | state   | execution_date               | start_date                  | end_date
================+=============================+=========+==============================+=============================+==============================
example_complex | manual__2025-04-14T15:29:17 | success | 2025-04-14T15:29:17.298007+0 | 2025-04-14T15:29:17.556324+ | 2025-04-14T15:29:43.118988+00
                | .298007+00:00               |         | 0:00                         | 00:00                       | :00
example_complex | manual__2025-04-14T14:33:55 | success | 2025-04-14T14:33:55.429076+0 | 2025-04-14T14:33:55.901567+ | 2025-04-14T14:34:23.912882+00
                | .429076+00:00               |         | 0:00                         | 00:00                       | :00
Found a mistake? Seleсt text and press Ctrl+Enter to report it