---
title: "List workflow runs"
method: GET
path: "/v1/workflows/{workflowId}/executions"
tags: ["Workflows"]
---

# List workflow runs

`GET /v1/workflows/{workflowId}/executions`

Returns recent executions (runs) with their status, current node, and accumulated variables.

## Path parameters

- `workflowId` string, required

## Query parameters

- `status` 'running' | 'waiting' | 'completed' | 'exited' | 'failed'
- `limit` integer
- `skip` integer

## Response `200`

Executions list

- object
  - `success` boolean
  - `executions` object[]
    - `id` string
    - `status` 'running' | 'waiting' | 'completed' | 'exited' | 'failed'
    - `currentNodeId` string
    - `waitingFor` object, nullable
      - `kind` 'timer' | 'reply'
      - `nodeId` string
    - `variables` object
    - `platformIdentifier` string
    - `conversationId` string
    - `stepCount` integer
    - `lastError` string, nullable
    - `resumeAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `completedAt` string, date-time, nullable
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `skip` integer
    - `hasMore` boolean

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)