---
title: "List Workflow Executions"
method: GET
path: "/workspaces/{workspace_id}/workflow-executions"
tags: ["workflow-executions"]
---

# List Workflow Executions

`GET /workspaces/{workspace_id}/workflow-executions`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/workspaces/{workspace_id}/workflow-executions`
- Auth: one of:
  - API key in cookie `fastapiusersauth`
  - HTTP bearer

List all workflow executions.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `trigger` TriggerType[], nullable
- `limit` integer, nullable
- `workflow_id` union
  - string
  - string
- `user_id` union
  - string, uuid
  - 'current': A sentinel user ID that represents the current user.

## Response `200`

Successful Response

- WorkflowExecutionReadMinimal[]
  - `id` string, required: The ID of the workflow execution
  - `run_id` string, required: The run ID of the workflow execution
  - `start_time` string, date-time, required: The start time of the workflow execution
  - `execution_time` string, date-time, nullable: When this workflow run started or should start.
  - `close_time` string, date-time, nullable: When the workflow was closed if closed.
  - `status` 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT', required
  - `workflow_type` string, required
  - `task_queue` string, required
  - `history_length` integer, required: Number of events in the history
  - `parent_wf_exec_id` string, nullable
  - `trigger_type` 'manual' | 'scheduled' | 'webhook' | 'case' | 'form', required: Trigger type for a workflow execution.
  - `execution_type` 'draft' | 'published': Execution type for a workflow execution. Distinguishes between draft (development) and published (production) executions.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)