---
title: "List the workflow runs of a workflow."
method: GET
path: "/workflow-runner/workflows/{workflowId}/runs"
tags: ["Workflow Runner"]
---

# List the workflow runs of a workflow.

`GET /workflow-runner/workflows/{workflowId}/runs`

## Path parameters

- `workflowId` string, required

## Query parameters

- `page` integer
- `size` integer
- `sortBy` string

## Response `200`

Ok

- WorkflowRunnerPublicWorkflowRunOverview[]
  - `creationTimestamp` string, date-time
  - `error` union
    - WorkflowRunnerWorkflowRunError — Error information for a failed workflow run. Present only when the run is in the FAILED state.
      - `code` string
      - `details` object
      - `message` string
    - unknown
  - `hasRecycledOperation` boolean
  - `lastProcessed` string, date-time
  - `outputDataMap` union
    - WorkflowsSerializableDataMap — Data map provides the mapping of each data - according to the data interface of a method or a workflow - and each parameter value combination to the data identifiers.
      - `dataByNameAndParameterValueCombinationId` object
      - `parameterValueCombinationsById` object
    - unknown
  - `projectId` string
  - `state` 'CREATED' | 'RUNNING' | 'PAUSED' | 'CANCELING' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' — Workflow run state is a higher-level state describing overall progression.
  - `workflowId` string, nullable — Workflow identifier. It is a string composed of the type identifier and a UUID: `workflow:[UUID]`.
  - `workflowRunId` string — Workflow run identifier. It is a string composed of the type identifier and a UUID: `workflow.run:[UUID]`.
  - `workflowRunMode` 'DRY' | 'REAL'
  - `workflowRunName` string, nullable
  - `workflowTypeReference` string — Reference to a component version. Components are organized into a group hierarchy which serves as a qualification mechanism to avoid collisions and also to group components semantically. Component versions follow the convention of semantic versioning. The fully qualified reference of a component version follows the following syntax: `[component_group]:[component]:[component_version]`.
  - `workflowVersionId` string, nullable — Workflow version identifier. It is a string composed of the type identifier and a UUID: `workflow.version:[UUID]`.

---

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