list-jobs

Definition

Displays information about jobs.

Usage

$ airflow dags list-jobs [-h] [-d DAG_ID] [--limit LIMIT]
                       [-o table, json, yaml, plain]
                       [--state running, success, restarting, failed] [-v]

Arguments

Parameter Description

-d, --dag-id

The ID of the DAG

--limit

Return a limited number of records

--state

Only list the jobs with a specific state. Possible values: running, success, restarting, 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

To display the failed jobs, run:

$ airflow dags list-jobs --state failed

Output example:

dag_id | state  | job_type     | start_date                       | end_date
=======+========+==============+==================================+=========
None   | failed | SchedulerJob | 2025-04-13 06:05:32.765139+00:00 | None
None   | failed | SchedulerJob | 2025-04-04 07:04:45.232394+00:00 | None
None   | failed | SchedulerJob | 2025-03-20 08:14:14.726727+00:00 | None
None   | failed | SchedulerJob | 2025-03-18 08:42:55.290413+00:00 | None
None   | failed | SchedulerJob | 2025-03-12 12:26:23.617197+00:00 | None
None   | failed | SchedulerJob | 2025-03-10 08:30:22.448855+00:00 | None
None   | failed | SchedulerJob | 2025-03-06 10:55:55.349423+00:00 | None
Found a mistake? Seleсt text and press Ctrl+Enter to report it