---
title: "List Workflow runs"
method: GET
path: "/api/v2/workflows/runs"
tags: ["Workflows"]
---

# List Workflow runs

`GET /api/v2/workflows/runs`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/workflows/runs`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/workflows/runs/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of workflow runs

## Query parameters

- `workflow_id` string
- `limit` integer
- `skip` integer

## Response `200`

Workflow runs retrieved successfully

- JumpcloudHttpWorkflowsWorkflowRunListResponse: Response containing a list of workflow runs with pagination metadata
  - `totalCount` integer, required: Total number of workflow runs available
  - `results` JumpcloudHttpWorkflowsWorkflowRunResponse[], required: List of workflow runs
    - `id` string: Unique identifier of the workflow run
    - `workflowId` string: Unique identifier of the workflow
    - `status` string: Status of the workflow run
    - `startedAt` string, date-time: Timestamp when the workflow run started
    - `completedAt` string, date-time, nullable: Timestamp when the workflow run completed
    - `name` string: Name of the workflow
    - `description` string: Description of the workflow
    - `error` string: error message
    - `workflowDeletedAt` string, date-time, nullable: Timestamp when the parent workflow was deleted
    - `input` object: Input data that was provided when the workflow run was triggered
    - `executionDetails` object, nullable: Execution details for the workflow run. Mirrors persisted workflow_runs.execution_details (top-level { "nodes": [...] }).

## Other responses

- `400`: Bad request - invalid ID format
- `401`: Unauthorized - authentication required
- `404`: Workflow not found
- `default`: Generic error response

---

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