> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Workflow Run

> Read one workflow run

Read a single workflow run: one agent conducting one workflow on one lead.

## Authentication

Requires the `x-api-key` header with a valid workspace API key.

## Path Parameters

<ParamField path="workflowRunId" type="string" required>
  The workflow run id returned by
  [Create Workflow Run](/api-reference/workflow-runs/create-workflow-run).
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded.
</ResponseField>

<ResponseField name="workflowRun" type="object">
  The workflow run.

  <Expandable title="workflowRun">
    <ResponseField name="id" type="string">
      The workflow run id. This is what pause, resume, cancel, and complete act on, and
      what the `workflow_run.*` webhooks carry as `workflowRun.id`.
    </ResponseField>

    <ResponseField name="leadId" type="string">
      The lead the workflow is conducted on.
    </ResponseField>

    <ResponseField name="agentId" type="string">
      The agent conducting the workflow. Look the name up with
      [List Agents](/api-reference/agents/list-agents).
    </ResponseField>

    <ResponseField name="workflowId" type="string">
      The workflow being conducted. Look the name and type up with
      [List Workflows](/api-reference/workflows/list-workflows).
    </ResponseField>

    <ResponseField name="status" type="string">
      `ACTIVE`, `PAUSED`, `COMPLETED`, or `CANCELLED`. The last two are final.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      When the workflow run started.
    </ResponseField>

    <ResponseField name="completedAt" type="string | null">
      When the workflow run completed, or `null`.
    </ResponseField>

    <ResponseField name="cancelledAt" type="string | null">
      When the workflow run was cancelled, or `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

<ResponseField name="404" type="error">
  No workflow run with this id exists in your workspace.
</ResponseField>

<RequestExample>
  ```javascript Node.js theme={null}
  const options = {
    method: "GET",
    headers: { "x-api-key": "<your-api-key>" },
  };

  fetch(
    "https://api-v2.getomni.ai/api/v1/workflow-runs/5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9",
    options,
  )
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));
  ```

  ```python Python theme={null}
  import requests

  url = "https://api-v2.getomni.ai/api/v1/workflow-runs/5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9"
  headers = {"x-api-key": "<your-api-key>"}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```bash cURL theme={null}
  curl --request GET \
    --url https://api-v2.getomni.ai/api/v1/workflow-runs/5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9 \
    --header 'x-api-key: <your-api-key>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "workflowRun": {
      "id": "5d8c1b2a-3e4f-5061-7283-94a5b6c7d8e9",
      "leadId": "b1f0a790-201b-47e9-84ed-cc7eed1270c5",
      "agentId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "workflowId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "ACTIVE",
      "createdAt": "2026-09-10T17:42:03.000Z",
      "completedAt": null,
      "cancelledAt": null
    }
  }
  ```
</ResponseExample>