---
title: "List child tasks for an individual task"
method: GET
path: "/api/v1/tasks/{taskId}/children"
tags: ["Tasks"]
---

# List child tasks for an individual task

`GET /api/v1/tasks/{taskId}/children`

## Request

- Base URL: `https://brew.marketbrew.ai/api/v1`
- URL: `https://brew.marketbrew.ai/api/v1/api/v1/tasks/{taskId}/children`
- Auth: API key in header `API-Key`

Returns the child implementation tasks for a visible current or archived parent task.

## Path parameters

- `taskId` integer, required

## Query parameters

- `boostFactorId` integer
- `endDate` string
- `offset` integer
- `pageSize` integer
- `rankingSensorId` integer
- `serverHost` string
- `snapshotId` integer
- `sortBy` string
- `sortDir` string
- `startDate` string
- `taskTitle` string
- `webpageId` integer
- `websiteId` integer
- `workspaceId` integer

## Response `200`

A paginated collection of child task rows.

- TaskListResponse
  - `tasks` TaskDTO[]
    - `taskId` integer
    - `taskKey` string
    - `parentTaskId` integer
    - `taskTitle` string
    - `summary` string
    - `description` string
    - `taskType` integer
    - `taskTypeLabel` string
    - `optimizationScore` number
    - `hoursRequired` number
    - `previousCompletionPercentage` integer
    - `completionPercentage` integer
    - `progressDelta` integer
    - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED'
    - `childCount` integer
    - `archived` boolean
    - `snapshotId` integer
    - `snapshotDate` string, date-time
    - `rankingSensorId` integer
    - `rankingSensorName` string
    - `correlationKeyword` string
    - `websiteId` integer
    - `webpageId` integer
    - `boostFactorId` integer
    - `serverHost` string
    - `pagePath` string
  - `total` integer
  - `offset` integer
  - `pageSize` integer
  - `hasMore` boolean

## Other responses

- `404`: The parent task does not exist or is outside the authenticated customer scope.

---

[API](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation.md) · [All operations](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/revisions/11e3674a43d7?raw)