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

# GET /api/v1/workflows/runs

`GET /api/v1/workflows/runs`

## Query parameters

- `workflowId` string
- `status` string
- `limit` integer

## Response `200`

List all workflow runs with metadata

- object
  - `runs` object[]
    - `id` string
    - `workflowId` string
    - `organizationId` string
    - `status` 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TERMINATED' | 'CONTINUED_AS_NEW' | 'TIMED_OUT' | 'UNKNOWN'
    - `startTime` string, date-time
    - `endTime` string, date-time, nullable
    - `temporalRunId` string
    - `workflowVersionId` string, nullable
    - `workflowVersion` number, nullable
    - `workflowName` string
    - `eventCount` number
    - `nodeCount` number
    - `duration` number
    - `triggerType` 'manual' | 'schedule' | 'api'
    - `triggerSource` string, nullable
    - `triggerLabel` string, nullable
    - `inputPreview` object
      - `runtimeInputs` object
      - `nodeOverrides` object

## Changes

> 49 revisions in range; 1 could not be searched.

- **2025-12-08** `08fb21a4dc5c` — 4 info
  - added the optional property `runs/items/inputPreview` to the response with the `200` status
  - added the optional property `runs/items/triggerLabel` to the response with the `200` status
  - added the optional property `runs/items/triggerSource` to the response with the `200` status
  - added the optional property `runs/items/triggerType` to the response with the `200` status
- **2025-11-04** `b0518ab33431` — 1 info
  - endpoint added
- **2025-10-24** `8db531c050e5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/shipsecai/apis/shipsec-studio-api/changes/api/v1/workflows/runs/get.md)

---

[API](https://skmtc.dev/shipsecai/apis/shipsec-studio-api.md) · [All operations](https://skmtc.dev/shipsecai/apis/shipsec-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shipsecai/shipsec-studio-api/revisions/cc60562ad9f3/schema)