---
title: "Retrieve workflow run"
method: GET
path: "/v1/activity/workflow-runs/{workflowRunId}"
---

# Retrieve workflow run

`GET /v1/activity/workflow-runs/{workflowRunId}`

Retrieve detailed information for a specific workflow run by ID.

## Path parameters

- `workflowRunId` string, required

## Response `200`

- GetWorkflowRunResponseDto
  - `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` StepRunDto[], required — Step runs
    - `stepRunId` string, required — Step run 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
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, required — Update timestamp
    - `executionDetails` StepExecutionDetailDto[], required — Execution details
      - `_id` string, required — Unique identifier of the execution detail
      - `createdAt` string — Creation time of the execution detail
      - `status` 'Success' | 'Warning' | 'Failed' | 'Pending' | 'Queued' | 'ReadConfirmation', required — Status of the execution detail
      - `detail` string, required — Detailed information about the execution
      - `providerId` string — Provider identifier
      - `raw` object, nullable — Raw data of the execution
    - `digest` DigestMetadataDto
      - `digestKey` string — Optional key for the digest
      - `amount` number — Amount for the digest
      - `unit` 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' — Unit of the digest
      - `type` 'regular' | 'backoff' | 'timed', required — The Digest Type
      - `events` object[] — Optional array of events associated with the digest, represented as key-value pairs
      - `backoff` boolean — Regular digest: Indicates if backoff is enabled for the regular digest
      - `backoffAmount` number — Regular digest: Amount for backoff
      - `backoffUnit` 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' — Regular digest: Unit for backoff
      - `updateMode` boolean — Regular digest: Indicates if the digest should update
      - `timed` DigestTimedConfigDto
        - `atTime` string — Time at which the digest is triggered
        - `weekDays` string[] — Days of the week for the digest
        - `monthDays` number[] — Specific days of the month for the digest
        - `ordinal` '1' | '2' | '3' | '4' | '5' | 'last' — Ordinal position for the digest
        - `ordinalValue` 'day' | 'weekday' | 'weekend' | 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' — Value of the ordinal
        - `monthlyType` 'each' | 'on' — Type of monthly schedule
        - `cronExpression` string — Cron expression for scheduling
        - `untilDate` string — Until date for scheduling
    - `scheduleExtensionsCount` number — The number of times the digest/delay job has been extended to align with the subscribers schedule
  - `payload` object, required — Trigger payload
  - `overrides` object — Trigger overrides passed to the original workflow trigger

---

[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/versions/986fe259fa85/schema)