---
title: "Get workflow run by id"
method: GET
path: "/workflows/runs/{runId}"
tags: ["Workflows"]
---

# Get workflow run by id

`GET /workflows/runs/{runId}`

## Request

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

Get a workflow run by its ID

## Path parameters

- `runId` string, required

## Response `200`

Workflow run retrieved successfully

- JumpcloudHttpWorkflowsWorkflowRunResponse: Response containing a workflow run
  - `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 run not found
- `default`: Generic error response

---

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