---
title: "List Executions"
method: GET
path: "/v3/workflow-executions"
tags: ["v3", "workflow-executions-v3"]
---

# List Executions

`GET /v3/workflow-executions`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v3/workflow-executions`
- Auth: HTTP bearer

List v3 workflow executions with pagination and filtering.

## Query parameters

- `status` WorkflowBusinessStatus[], nullable
- `workflow_id` string[], nullable
- `timeframe` 'last_7_days' | 'last_30_days' | 'this_week' | 'this_month' | 'last_3_months' | 'last_6_months' | 'last_year'
- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable
- `search` string, nullable
- `load_id` string, nullable
- `page` integer: Page number
- `size` integer: Page size

## Headers

- `mentium-workspace-id` string, nullable

## Response `200`

Successful Response

- PageWorkflowExecutionListItem
  - `items` WorkflowExecutionListItem[], required
    - `id` string, required
    - `workflow_id` string, required
    - `workflow_name` string, nullable
    - `version` integer, required
    - `execution_status` string, required
    - `business_status` string, nullable
    - `title` string, nullable
    - `subtitle` string, nullable
    - `load_id` string, nullable
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `assignee` object, nullable
    - `temporal_link` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required

## Other responses

- `404`: Not found
- `422`: Validation Error

---

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