get_dag_runs

get_dag_runs

Retrieve DAG runs for a specific DAG, filtering by date ranges, state, and ordering results. Supports pagination and precise querying in Apache Airflow.

Instructions

Get DAG runs for a specific DAG

Input Schema

Name	Required	Description
`dag_id`	Yes	The ID of the DAG to retrieve DAG runs for
`end_date_gte`	No	Returns objects greater or equal the specified date
`end_date_lte`	No	Returns objects less than or equal to the specified date
`execution_date_gte`	No	Returns objects greater or equal to the specified date
`execution_date_lte`	No	Returns objects less than or equal to the specified date
`limit`	No	The numbers of items to return (default: 100)
`offset`	No	The number of items to skip before starting to collect the result set
`order_by`	No	The name of the field to order the results by. Prefix with - to reverse sort order
`start_date_gte`	No	Returns objects greater or equal the specified date
`start_date_lte`	No	Returns objects less or equal the specified date
`state`	No	The value can be repeated to retrieve multiple matching values (OR condition)
`updated_at_gte`	No	Returns objects greater or equal the specified date
`updated_at_lte`	No	Returns objects less or equal the specified date

Input Schema (JSON Schema)

{
  "properties": {
    "dag_id": {
      "description": "The ID of the DAG to retrieve DAG runs for",
      "type": "string"
    },
    "end_date_gte": {
      "description": "Returns objects greater or equal the specified date",
      "format": "date-time",
      "type": "string"
    },
    "end_date_lte": {
      "description": "Returns objects less than or equal to the specified date",
      "format": "date-time",
      "type": "string"
    },
    "execution_date_gte": {
      "description": "Returns objects greater or equal to the specified date",
      "format": "date-time",
      "type": "string"
    },
    "execution_date_lte": {
      "description": "Returns objects less than or equal to the specified date",
      "format": "date-time",
      "type": "string"
    },
    "limit": {
      "description": "The numbers of items to return (default: 100)",
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "description": "The number of items to skip before starting to collect the result set",
      "minimum": 0,
      "type": "integer"
    },
    "order_by": {
      "description": "The name of the field to order the results by. Prefix with - to reverse sort order",
      "type": "string"
    },
    "start_date_gte": {
      "description": "Returns objects greater or equal the specified date",
      "format": "date-time",
      "type": "string"
    },
    "start_date_lte": {
      "description": "Returns objects less or equal the specified date",
      "format": "date-time",
      "type": "string"
    },
    "state": {
      "description": "The value can be repeated to retrieve multiple matching values (OR condition)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "updated_at_gte": {
      "description": "Returns objects greater or equal the specified date",
      "format": "date-time",
      "type": "string"
    },
    "updated_at_lte": {
      "description": "Returns objects less or equal the specified date",
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "dag_id"
  ],
  "type": "object"
}

MCP Server for Apache Airflow

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Server for Apache Airflow

Related Tools