---
title: "List Runs"
method: GET
path: "/v1/workflows/runs"
tags: ["workflows.runs"]
---

# List Runs

`GET /v1/workflows/runs`

List Runs

## Query parameters

- `workflow_identifier` string, nullable — Filter by workflow name or id
- `root_execution_id` string, nullable — Filter by root execution id; returns the whole execution tree (the root and all its descendant sub-workflows).
- `search` string, nullable — Search by workflow name, display name, or ID
- `status` union — Filter by workflow status
  - 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'RETRYING_AFTER_ERROR'
  - WorkflowExecutionStatus[]
- `deployment_name` string, nullable — Filter by deployment name
- `sort_by` 'start_time' | 'end_time', nullable — Field to sort by
- `order` 'asc' | 'desc' — Sort direction
- `start_time_after` string, date-time, nullable — Include runs with start_time >= value
- `start_time_before` string, date-time, nullable — Include runs with start_time <= value
- `end_time_after` string, date-time, nullable — Include runs with end_time >= value. Running executions (no end_time) are excluded; use the status filter to include them.
- `end_time_before` string, date-time, nullable — Include runs with end_time <= value. Running executions (no end_time) are excluded; use the status filter to include them.
- `user_id` string, nullable — Filter by user id. Use 'current' to filter by the authenticated user
- `workflow_tags` string[], nullable — Filter to runs of workflows tagged with all listed tags (AND).
- `include_internal` boolean — Include runs of internal/technical workflows (e.g. parallel-execution)
- `page_size` integer — Number of items per page
- `next_page_token` string, nullable — Token for the next page of results
- `search_key` string[], nullable — Filter executions by search key as repeated 'key:value' entries. Each entry matches an exact key and a similar value; multiple entries are AND'd together (max 3).

## Response `200`

Successful Response

- WorkflowExecutionListResponse — Deprecated: use WorkflowRunListResponse instead. Will be removed in the next major version.
  - `executions` WorkflowExecutionWithoutResultResponse[], required — A list of workflow executions
    - `workflow_name` string, required — The name of the workflow
    - `workflow_id` string, uuid, nullable — The ID of the workflow
    - `deployment_name` string, nullable — The name of the deployment that ran this execution
    - `execution_id` string, required — The ID of the workflow execution
    - `parent_execution_id` string, nullable — The parent execution ID of the workflow execution
    - `root_execution_id` string, required — The root execution ID of the workflow execution
    - `run_id` string, nullable — The unique run identifier (database UUID)
    - `user_id` string, nullable — The ID of the user who triggered the execution
    - `status` 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'RETRYING_AFTER_ERROR', required
    - `start_time` string, date-time, required — The start time of the workflow execution
    - `end_time` string, date-time, nullable, required — The end time of the workflow execution, if available
    - `total_duration_ms` integer, nullable — The total duration of the trace in milliseconds
  - `next_page_token` string, nullable — Token to use for fetching the next page of results. Null if this is the last page.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)