---
title: "Get Task Run Status"
method: GET
path: "/v2/tasks/runs/{runId}/status"
tags: ["Tasks"]
---

# Get Task Run Status

`GET /v2/tasks/runs/{runId}/status`

Retrieves the current status and result of a task run in the V2 tasks API.

## Path parameters

- `runId` string, required

## Response `200`

Task run status retrieved successfully

- TaskRunStatusResponse
  - `run_id` string, required — The ID of the task run
  - `status` 'queued' | 'running' | 'success' | 'failure' | 'timeout' | 'cancelled', required — Current task run status
  - `result` object — Task output when available
  - `error` string — Error message when the run fails
  - `session_id` string — Session ID used for this task run

## Other responses

- `404` — Task run not found
- `500` — Failed to retrieve task run status

## Changes

- **2026-03-20** `c1198ecebd31` — 2 info
  - api tag `Tasks` added
  - api tag `Tasks V2` removed
- **2026-02-25** `ae25b3e0f20d` — 1 info
  - endpoint added
- **2026-02-18** `4d2d945e5967` — 1 breaking
  - api path removed without deprecation
- **2026-02-18** `cdc369172404` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v2/tasks/runs/:runId/status/get.md)

---

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