GET/v1/runs/{run_hash}/stats

Get Run Stats

Retrieve detailed statistics about a specific run

This endpoint retrieves detailed real-time statistics about a specific run, including progress information, estimated time remaining, and task completion status.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Response Field Explanations

string

The run's unique identifier

Example: 300e9c5c127d421c90f431478d9a2cfb

object

string

Always "run"

Example: run

duration

string

Human-readable duration (HH:MM:SS format)

Example: 0:00:15.175532

started_at

string

When the run started

Example: 2025-02-10T14:30:55

ended_at

stringnull

When the run ended (null if still running)

Example: 2025-02-10T14:31:10

is_done

boolean

Whether the run has completed

Example: true

percent_done

string

Completion percentage

Example: 100%

eta

string

Estimated time remaining ("∞" if unknown)

Example: ∞

total_tasks

integer

Total number of tasks in the run

Example: 10

total_tasks_done

integer

Number of tasks completed

Example: 10

total_tasks_left

integer

Number of tasks remaining

Example: 0

total_results

integer

Total results collected in this run

Example: 6

results_total

integer

Expected total results (if known)

Example: 138

results_done

integer

Results collected so far

Example: 6

current_task

string

Currently executing task (empty if none)

Example: ""

updated_at

string

Last update timestamp

Example: 2025-02-10T14:31:10

Parameters

run_hashstring

Required

The unique identifier (hash) of the run

Example: 300e9c5c127d421c90f431478d9a2cfb

Pro Tip

Poll this endpoint periodically to display real-time progress in your application.

Note

The eta field provides an estimate but may show "∞" for runs with unpredictable completion times.

Pro Tip

Use percent_done for progress bars and total_tasks_left to show remaining work.