---
title: "Search workflow runs"
method: GET
path: "/workflow-runs"
tags: ["Workflow Runs"]
---

# Search workflow runs

`GET /workflow-runs`

Returns the latest 200 workflow runs of a workflow, showing the most recently updated first.

## Query parameters

- `workflowId` string
- `name` string
- `status` string
- `fields` string

## Response `200`

- ListWorkflowRunsResponse
  - `workflowRuns` object[]
    - `id` string, required — The ID of the Workflow Run
    - `audit` object, required — Creation and last-modification metadata.
      - `createdDate` string, date-time, required — When the resource was first created. ISO-8601 UTC.
      - `createdById` string, required — ID of the user who created the resource.
      - `updatedDate` string, date-time, required — When the resource was last modified. ISO-8601 UTC.
      - `updatedById` string, required — ID of the user who last modified the resource.
    - `name` string — Display name of the workflow run (often interpolated from a name template).
    - `status` 'Active' | 'Completed' | 'Archived' | 'Deleted', required — Lifecycle status of a workflow run. - `Active` — the run is in progress. - `Completed` — all tasks were completed and the run was finalised. - `Archived` — the run was archived from the active list (no further task progress is recorded but the run stays queryable). - `Deleted` — the run was soft-deleted. List endpoints return only `Active` runs unless otherwise indicated.
    - `workflowId` string, required — The ID of the Workflow
    - `shared` boolean, required — When `true`, this run is visible via its share link.
    - `dueDate` string, date-time — Optional workflow-level due date. ISO-8601 UTC.
    - `migrationStatus` 'Inactive' | 'Scheduled' | 'Migrating', required — Whether this run is currently being migrated to a newer workflow revision. - `Inactive` — not in a migration; this is the normal state. - `Scheduled` — a migration to a newer revision has been requested and is queued. - `Migrating` — migration is in progress; some fields may change shortly.
    - `links` object[] — Navigable HATEOAS links to related resources. Each entry has a `name` (RFC-5988 link relation like `self`, `edit`, `related`), an `href` URL, and a `type` (`Api` for callable endpoints, `App` for browser-facing URLs). Prefer following these `href` values over constructing URLs by hand.
      - `name` string, required — Standard link relation name (RFC 5988) indicating this link's role. Common values include `self`, `edit`, `related`, `previous`, `next`.
      - `href` string, required — URL of the linked resource.
      - `rel` 'Approval Task' | 'Approvals' | 'Assignees' | 'Comment' | 'Data Set Records' | 'Data Sets' | 'Form Field Values' | 'Subject Task' | 'Task' | 'Tasks' | 'Users' | 'Webhook' | 'Workflow' | 'Workflow Run' — Optional. The kind of resource this link points to (e.g. `Workflow`, `Task`, `Comment`).
      - `type` 'Api' | 'App', required — Whether this link targets an API endpoint or a Process Street app URL. `Api` — a callable API endpoint you can fetch directly. `App` — a browser-facing URL in the Process Street UI.

## Other responses

- `400` — Invalid value for: query parameters
- `default`

---

[API](https://skmtc.net/process/apis/process-street-public-api.md) · [All operations](https://skmtc.net/process/apis/process-street-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/process/process-street-public-api/revisions/6199a9464227/schema)