---
title: "GET /workflowruns"
method: GET
path: "/workflowruns"
tags: ["WorkflowRuns"]
---

# GET /workflowruns

`GET /workflowruns`

List workflow runs.

## Query parameters

- `api-version` string, required
- `viewMode` string
- `timeWindow` '1d' | '7d' | '30d' | '90d'
- `orderby` 'status desc' | 'status asc' | 'requestor desc' | 'requestor asc' | 'startTime desc' | 'startTime asc'
- `runStatuses` string[]
- `workflowIds` string[]
- `requestors` string[]
- `maxpagesize` integer

## Response `200`

OK

- WorkflowRunList
  - `value` WorkflowRunMetadata[], required — The value of workflow run list.
    - `id` string, uuid, required — The workflow run id.
    - `workflowId` string, uuid, required — The workflow id.
    - `startTime` string, date-time, required — Workflow run start time.
    - `requestor` string, uuid, required — The person who submitted the user request.
    - `userRequestId` string, uuid — The user request id.
    - `runPayload` WorkflowRunPayload, required — The input of a workflow run. Align with operation in user request.
      - `type` 'CreateTerm' | 'UpdateTerm' | 'DeleteTerm' | 'ImportTerms' | 'UpdateAsset' | 'GrantDataAccess', required — The workflow run payload type.
      - `targetValue` string, required — The target value which need involve workflow to update.
    - `status` 'NotStarted' | 'InProgress' | 'Failed' | 'Completed' | 'Canceling' | 'CancellationFailed' | 'Canceled', required — The status.
    - `endTime` string, date-time — The time of workflow run completed.
    - `cancelTime` string, date-time — The time of workflow run be canceled.
    - `cancelComment` string — The comment when cancel a workflow run.
  - `nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2022-05-01-preview) `60435bfd503d` — 3 info
  - api operation id `ListWorkflowRuns` removed and replaced with `WorkflowRuns_List`
  - added the new optional `query` request parameter `requestors`
  - added the new optional `query` request parameter `viewMode`

[Change history](https://skmtc.dev/azure/apis/purview-workflow/changes/workflowruns/get.md)

---

[API](https://skmtc.dev/azure/apis/purview-workflow.md) · [All operations](https://skmtc.dev/azure/apis/purview-workflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-workflow/revisions/60435bfd503d/schema)