---
title: "Poll a task result"
method: GET
path: "/runs/{id}"
---

# Poll a task result

`GET /runs/{id}`

## Request

- Base URL: `https://worker.openhelm.ai/v1`
- URL: `https://worker.openhelm.ai/v1/runs/{id}`
- Auth: HTTP bearer

## Response `200`

OK

- TaskEnvelope: Shared by the poll endpoint and the completion webhook. Webhook body is { "event": "run.completed" | "run.failed", "data": <this> }.
  - `task_id` string
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'needs_you'
  - `result` object, nullable: Best-effort object conforming to the run's output_schema.
  - `confidence` 'high' | 'medium' | 'low' | 'null', nullable
  - `evidence` object, nullable
    - `screenshot_url` string, nullable: Signed URL, valid 7 days
    - `matched_text` string, nullable
    - `checked_at` string, date-time
  - `failure_reason` 'captcha' | 'auth_required' | 'site_down' | 'timeout' | 'ambiguous' | 'not_found' | 'null', nullable
  - `usage` object
    - `duration_ms` integer, nullable
    - `input_tokens` integer
    - `output_tokens` integer
    - `cost_usd` number
  - `created_at` string, date-time
  - `finished_at` string, date-time, nullable

---

[API](https://skmtc.dev/openhelm/apis/openhelm-public-api.md) · [All operations](https://skmtc.dev/openhelm/apis/openhelm-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openhelm/apis/openhelm-public-api/revisions/2af88dc2f6a7?raw)