---
title: "Retrieve Task Group Run"
method: GET
path: "/v1/tasks/groups/{taskgroup_id}/runs/{run_id}"
tags: ["Tasks"]
---

# Retrieve Task Group Run

`GET /v1/tasks/groups/{taskgroup_id}/runs/{run_id}`

Retrieves run status by run_id.

This endpoint is equivalent to fetching run status directly using the
`retrieve()` method or the `tasks/runs` GET endpoint.

The run result is available from the `/result` endpoint.

## Path parameters

- `taskgroup_id` string, required
- `run_id` string, required

## Response `200`

Successful Response

- TaskRun — Status of a task run.
  - `run_id` string, required — ID of the task run.
  - `interaction_id` string, required — Identifier for this interaction. Pass this value as `previous_interaction_id` to reuse context for a future request.
  - `status` 'queued' | 'action_required' | 'running' | 'completed' | 'failed' | 'cancelling' | 'cancelled', required — Status of the run.
  - `is_active` boolean, required — Whether the run is currently active, i.e. status is one of {'cancelling', 'queued', 'running'}.
  - `warnings` Warning[], nullable — Warnings for the run, if any.
    - `type` 'spec_validation_warning' | 'input_validation_warning' | 'warning', required — Type of warning. Note that adding new warning types is considered a backward-compatible change.
    - `message` string, required — Human-readable message.
    - `detail` object, nullable — Optional detail supporting the warning.
  - `error` Error — An error message.
    - `ref_id` string, required — Reference ID for the error.
    - `message` string, required — Human-readable message.
    - `detail` object, nullable — Optional detail supporting the error.
  - `processor` string, required — Processor used for the run.
  - `metadata` object, nullable — User-provided metadata stored with the run.
  - `taskgroup_id` string, nullable — ID of the taskgroup to which the run belongs.
  - `created_at` string, nullable, required — Timestamp of the creation of the task, as an RFC 3339 string.
  - `modified_at` string, nullable, required — Timestamp of the last modification to the task, as an RFC 3339 string.

## Other responses

- `401` — Unauthorized: invalid or missing credentials
- `404` — Run id not found
- `422` — Request validation error

## Changes

> 21 revisions in range; 2 could not be searched.

- **2026-05-06** `84643ced9758` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1/tasks/groups/:taskgroup_id/runs/:run_id/get.md)

---

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