---
title: "Get Workflow Run (Live Status)"
method: GET
path: "/workflows/runs/{run_id}/live_status"
tags: ["Workflow"]
---

# Get Workflow Run (Live Status)

`GET /workflows/runs/{run_id}/live_status`

Get the live status and per-block progress for a workflow run.

## Path parameters

- `run_id` string, uuid, required

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- WorkflowLiveStatusResponse — Live status response for a single workflow run.
  - `run_id` string, required — Workflow run identifier.
  - `workflow_id` string, required — Workflow identifier.
  - `overall_status` string, required — Overall run status: queued, running, completed, or failed.
  - `current_block` string, nullable — Name of the block currently executing.
  - `current_block_sequence` integer, nullable — Sequence number of the block currently executing.
  - `total_blocks` integer — Total number of blocks in the workflow.
  - `completed_blocks` integer — Number of blocks that have finished.
  - `started_at` string, nullable — Timestamp when execution started.
  - `completed_at` string, nullable — Timestamp when execution finished.
  - `last_updated` string, required — Timestamp of the last status update.
  - `blocks` BlockLiveStatus[] — Live status for each block in the run.
    - `block_id` string, nullable — Block identifier within the workflow.
    - `block_name` string, required — Registered block type name (e.g. 'enrich_lead', 'find_email').
    - `sequence_number` integer, required — Position of the block in the workflow execution order.
    - `previous_block_ids` string[], nullable — IDs of upstream blocks that feed into this one.
    - `status` string, required — Block status: pending, running, completed, or failed.
    - `started_at` string, nullable — Timestamp when execution started.
    - `completed_at` string, nullable — Timestamp when execution finished.
    - `progress_percentage` number — Block progress (0-100).
    - `current_step` string, nullable — Human-readable description of the current sub-step.
    - `processed_count` integer — Number of items processed so far.
    - `total_count` integer — Total number of items to process.
    - `estimated_total_count` integer, nullable — Estimated total when an exact count isn't yet known.
    - `last_updated` string, required — Timestamp of the last status update.
    - `error_message` string, nullable — Error message if the operation failed.
    - `metrics` BlockMetrics, required — Metrics for a block execution.
      - `row_count` integer — Total rows produced by the block.
      - `dataframe_type` string — Logical row type produced (e.g. LEAD, COMPANY).
      - `processed_count` integer, nullable — Number of items processed so far.
      - `total_count` integer, nullable — Total number of items to process.
  - `overall_progress_percentage` number — Overall run progress (0-100).
  - `estimation_blocked_by` string, nullable — Block name preventing a full progress estimate, if any.

## Other responses

- `400` — Request was rejected by the route's validation rules.
- `401` — Missing or invalid API key.
- `403` — Caller does not have access to this workflow.
- `404` — Workflow, run, or job not found.
- `409` — Workflow with the supplied ID already exists.
- `422` — Request body failed validation.
- `500` — Unexpected server error. Retry with backoff.

---

[API](https://skmtc.dev/sixtyfour/apis/sixtyfour-api.md) · [All operations](https://skmtc.dev/sixtyfour/apis/sixtyfour-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sixtyfour/sixtyfour-api/revisions/51f0a2b62b44/schema)