---
title: "Fetch Task Group Runs"
method: GET
path: "/v1beta/tasks/groups/{taskgroup_id}/runs"
tags: ["Tasks"]
---

# Fetch Task Group Runs

`GET /v1beta/tasks/groups/{taskgroup_id}/runs`

Retrieves task runs in a TaskGroup and optionally their inputs and outputs.

All runs within a TaskGroup are returned as a stream. To get the inputs and/or
outputs back in the stream, set the corresponding `include_input` and
`include_output` parameters to `true`.

The stream is resumable using the `event_id` as the cursor. To resume a stream,
specify the `last_event_id` parameter with the `event_id` of the last event in the
stream. The stream will resume from the next event after the `last_event_id`.

## Path parameters

- `taskgroup_id` string, required

## Query parameters

- `last_event_id` string, nullable
- `status` 'queued' | 'action_required' | 'running' | 'completed' | 'failed' | 'cancelling' | 'cancelled', nullable
- `include_input` boolean
- `include_output` boolean

## Response `200`

Successful Response

## Other responses

- `404` — TaskGroup not found
- `422` — Validation Error

## Changes

- **2026-04-21** `57e1c56be094` — 8 info
  - api tag `Tasks` added
  - api tag `Tasks (Beta)` removed
  - added the optional property `oneOf[subschema #1: TaskRunEvent]/output/anyOf[subschema #1]/oneOf[subschema #1: TaskRunTextOutput]/mcp_tool_calls` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: TaskRunEvent]/output/anyOf[subschema #1]/oneOf[subschema #2: TaskRunJsonOutput]/mcp_tool_calls` to the response with the `200` status
  - …4 more
- **2026-03-09** `970b780e8649` — 2 info
  - added the optional property `oneOf[subschema #1: TaskRunEvent]/input/anyOf[subschema #1: BetaTaskRunInput]/previous_interaction_id` to the response with the `200` status
  - added the required property `oneOf[subschema #1: TaskRunEvent]/run/interaction_id` to the response with the `200` status
- **2026-01-13** `105d778ad64d` — 1 breaking, 31 info
  - the `error` response's property type/format changed from ``/`` to `object`/`` for status `404`
  - added the optional property `error/detail` to the response with the `404` status
  - added the optional property `oneOf[subschema #1: TaskRunEvent]/input/anyOf[subschema #1: BetaTaskRunInput]/source_policy/anyOf[subschema #1: SourcePolicy]/after_date` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: TaskRunEvent]/run/error` to the response with the `200` status
  - …28 more
- …earlier changes not shown

[Full history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1beta/tasks/groups/:taskgroup_id/runs/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/57e1c56be094/schema)