---
title: "List workflow runs"
method: GET
path: "/v1/activity/workflow-runs"
---

# List workflow runs

`GET /v1/activity/workflow-runs`

Retrieve a list of workflow runs with optional filtering and pagination.

## Query parameters

- `limit` number, required
- `cursor` string
- `workflowIds` string[]
- `subscriberIds` string[]
- `transactionIds` string[]
- `statuses` string[]
- `channels` string[]
- `topicKey` string
- `subscriptionId` string
- `createdGte` string
- `createdLte` string
- `severity` string[]
- `contextKeys` string[]

## Response `200`

- GetWorkflowRunsResponseDto
  - `data` GetWorkflowRunsDto[], required — Workflow runs data
    - `id` string, required — Workflow run id
    - `workflowId` string, required — Workflow identifier
    - `workflowName` string, required — Workflow name
    - `organizationId` string, required — Organization identifier
    - `environmentId` string, required — Environment identifier
    - `internalSubscriberId` string, required — Internal subscriber identifier
    - `subscriberId` string — External subscriber identifier
    - `status` 'processing' | 'completed' | 'error', required — Workflow run status
    - `deliveryLifecycleStatus` 'pending' | 'sent' | 'errored' | 'skipped' | 'canceled' | 'merged' | 'delivered' | 'interacted', required — Workflow run delivery lifecycle status
    - `triggerIdentifier` string, required — Trigger identifier
    - `transactionId` string, required — Transaction identifier
    - `createdAt` string, required — Creation timestamp
    - `updatedAt` string, required — Update timestamp
    - `severity` 'high' | 'medium' | 'low' | 'none', required — Severity
    - `critical` boolean, required — Critical flag
    - `contextKeys` string[] — Context (single or multi) in which the workflow run was executed
    - `topics` TopicResponseDto[] — Topics
      - `_id` string, required — The identifier of the topic
      - `key` string, required — The unique key of the topic
      - `name` string — The name of the topic
      - `createdAt` string — The date the topic was created
      - `updatedAt` string — The date the topic was last updated
    - `steps` WorkflowRunStepsDetailsDto[], required — Workflow run steps
      - `id` string, required — Step run identifier
      - `stepRunId` string, required — Step identifier
      - `stepId` string, required — Step identifier
      - `stepType` string, required — Step type
      - `providerId` string — Provider identifier
      - `status` 'pending' | 'queued' | 'running' | 'completed' | 'failed' | 'delayed' | 'canceled' | 'merged' | 'skipped', required — Step status
  - `next` object, nullable — Next cursor for pagination
  - `previous` object, nullable — Previous cursor for pagination

---

[API](https://skmtc.net/novu/apis/deprecated-novu-api-use-openapi-json-yaml-instead.md) · [All operations](https://skmtc.net/novu/apis/deprecated-novu-api-use-openapi-json-yaml-instead/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novu/deprecated-novu-api-use-openapi-json-yaml-instead/revisions/986fe259fa85/schema)