---
title: "Retrieve Task Group"
method: GET
path: "/v1beta/tasks/groups/{taskgroup_id}"
tags: ["Tasks (Beta)"]
---

# Retrieve Task Group

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

Retrieves aggregated status across runs in a TaskGroup.

## Path parameters

- `taskgroup_id` string, required

## Response `200`

Successful Response

- TaskGroupResponse — Response object for a task group, including its status and metadata.
  - `taskgroup_id` string, required — ID of the group.
  - `metadata` object, nullable — User-provided metadata stored with the group.
  - `status` TaskGroupStatus, required — Status of a task group.
    - `num_task_runs` integer, required — Number of task runs in the group.
    - `task_run_status_counts` object, required — Number of task runs with each status.
    - `is_active` boolean, required — True if at least one run in the group is currently active, i.e. status is one of {'cancelling', 'queued', 'running'}.
    - `status_message` string, nullable, required — Human-readable status message for the group.
    - `modified_at` string, nullable, required — Timestamp of the last status update to the group, as an RFC 3339 string.
  - `created_at` string, nullable, required — Timestamp of the creation of the group, as an RFC 3339 string.

## Other responses

- `422` — Validation Error

## Changes

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

- **2026-05-06** `84643ced9758` — 2 info
  - api tag `Tasks (Beta)` added
  - api tag `Tasks` removed
- **2026-04-21** `57e1c56be094` — 2 info
  - api tag `Tasks` added
  - api tag `Tasks (Beta)` removed
- **2026-01-13** `105d778ad64d` — 1 breaking, 6 info
  - the `status` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/TaskGroupStatus` from the `status` response property `allOf` list for the response status `200`
  - added the required property `status/is_active` to the response with the `200` status
  - added the required property `status/modified_at` to the response with the `200` status
  - …3 more
- **2025-11-06** `a2d634b57a8e` — 2 info
  - api tag `Tasks (Beta)` added
  - api tag `Task API (Beta)` removed
- **2025-08-31** `1aeb1c81a849` — 1 info
  - endpoint added

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