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

# List workflow runs

`GET /workflows/v1/runs`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/workflows/v1/runs`
- Auth: HTTP bearer

Returns paginated runs and node executions for a workflow the API key user can edit.

## Query parameters

- `workflowId` string, uuid, required
- `limit` integer
- `cursor` string, uuid
- `runId` string, uuid
- `runMode` 'test' | 'production'
- `status` 'PENDING' | 'IN_PROGRESS' | 'AWAITING_INPUT' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
- `from` string
- `to` string
- `version` string

## Response `200`

Workflow runs returned successfully

## Other responses

- `400`: Invalid query, from without to, to earlier than from, or runMode that disagrees with version
- `401`: Invalid or missing API key
- `403`: Missing WORKFLOW_API scope or editor access. A missing workflow, a template, or a workflow in another workspace also returns this status.
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/workflows/v1/runs/get.md)

---

[API](https://skmtc.dev/langdock/apis/langdock-api.md) - [All operations](https://skmtc.dev/langdock/apis/langdock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdock/apis/langdock-api/revisions/c62bf90b4013?raw)