---
title: "List workflow runs"
method: GET
path: "/api/v1/workflows/runs"
tags: ["Workflows"]
---

# List workflow runs

`GET /api/v1/workflows/runs`

## Request

- Base URL: `https://api.getcortexapp.com`
- URL: `https://api.getcortexapp.com/api/v1/workflows/runs`
- Auth: HTTP bearer

List workflow runs based on filters.

API key must have the `View workflow runs` permission.

## Query parameters

- `includeContext` boolean
- `workflowIds` string[]
- `searchQuery` string
- `entityId` string
- `initiatedBy` string[]
- `startedAfter` string
- `startedBefore` string
- `page` integer
- `size` integer
- `sort` string[]

## Response `200`

Successfully found workflow runs

- PaginatedResultWorkflowRunSummaryResponse
  - `hasMore` boolean, required
  - `items` WorkflowRunSummaryResponse[], required
    - `completedAt` string: Time the workflow run completed
    - `context` object: Context of the run. Omitted when the request sets `includeContext=false`, which is the default for MCP clients.
    - `id` string, required: Id of the run
    - `initiatedBy` union
      - ApiKey: Who initiated the workflow run
        - `type` string, required
        - `apiKey` union
          - Global
            - `id` string, required
            - `last4` string, required
            - `name` string
            - `type` string, required
          - Personal
            - `id` string, required
            - `last4` string, required
            - `name` string
            - `type` string, required
            - `user` CortexUserSummary: The user who verified the entity. Null while the status is PENDING, and null when a global API key verified it.
              - …
      - User
        - `email` string: Contact email
        - `name` string, required: Name
    - `runResponse` string
    - `startedAt` string: Time the workflow run started
    - `status` 'NOT_INITIATED' | 'IN_PROGRESS' | 'PAUSED' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT', required: Status of the workflow run. `PAUSED` means it waits for a user input or an approval.
    - `variables` object, required: Variable values
    - `workflow` WorkflowSummary, required: Summary of the workflow
      - `cid` string, required: The id of the workflow
      - `name` string, required: The slug of the workflow
  - `page` integer, required
  - `total` integer, required
  - `totalCapped` boolean, required
  - `totalPages` integer, required

## Other responses

- `429`: The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

## Changes

- **2026-11-03** `a7b058663c95`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cortex/apis/cortex-api/changes/api/v1/workflows/runs/get.md)

---

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