---
title: "Get all subtasks for a personal task"
method: GET
path: "/v1/tasks/{parentTaskId}/subtasks"
tags: ["Personal Subtasks"]
---

# Get all subtasks for a personal task

`GET /v1/tasks/{parentTaskId}/subtasks`

Retrieve all subtasks for a given personal task with optional filters and sorting

## Path parameters

- `parentTaskId` integer, required

## Query parameters

- `title` string — Title of the task
- `status` string[]
- `priority` string[]
- `tags` string[]
- `creators` integer[]
- `owners` integer[]
- `startDate` string, date-time — Start date
- `dueDate` string, date-time — Due date
- `createdTime` string, date-time — Created time
- `modifiedTime` string, date-time — Modified time
- `overdue` boolean — Whether the task is overdue
- `dueDateSet` boolean — Whether the due date is set
- `pending` boolean — Whether the task is pending
- `upcoming` boolean — Whether the task is upcoming
- `customFields` string — Custom fields filter as JSON string
- `page` integer
- `size` integer
- `sort` string[]

## Headers

- `X-Org-Id` integer, required

## Response `200`

Subtasks fetched successfully

- ApiSuccessResponseTaskListResponse — Standard API success response structure
  - `success` boolean — Indicates if the operation was successful
  - `message` string — Message describing the result of the operation
  - `code` integer — HTTP status code of the response
  - `data` TaskListResponse
    - `tenantId` integer
    - `tasks` TaskDto[]
      - `tenantId` integer
      - `taskId` integer
      - `taskTitle` string
      - `description` string
      - `descriptionMentionedUserIds` integer[]
      - `startDate` string, date-time
      - `dueDate` string, date-time
      - `noOfDays` integer
      - `completion` integer
      - `priority` TaskPriorityDto
        - `tenantId` integer
        - `taskPriorityId` integer
        - `priorityLabel` string
        - `color` string
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `default` boolean
        - `primary` boolean
      - `status` TaskStatusDto
        - `tenantId` integer
        - `taskStatusId` integer
        - `statusName` string
        - `color` string
        - `statusCategory` string
        - `projectId` integer
        - `spaceId` integer
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `default` boolean
        - `primary` boolean
      - `taskTags` TagDto[]
        - `tenantId` integer
        - `tagId` integer
        - `tagName` string
        - `color` string
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `taskCount` integer
        - `projectCount` integer
      - `overdueStatus` boolean
      - `parentId` integer
      - `taskListId` integer
      - `createdByMail` string
      - `senderName` string
      - `createdBy` UserMinimalDto
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `modifiedBy` UserMinimalDto
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `modifiedTime` string, date-time
      - `createdTime` string, date-time
      - `deleted` boolean
      - `deletedBy` UserMinimalDto
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `deletedTime` string, date-time
      - `completedTime` string, date-time
      - `timer` integer
      - `messageId` string
      - `owners` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `followers` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `taggedUsers` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `members` UserMinimalDto[]
        - `userId` integer
        - `firstName` string
        - `email` string
        - `profilePicURL` string
        - `profilePicColor` string
        - `provider` string
        - `role` OrgRoleDto
          - `orgRoleId` integer
          - `roleName` string
      - `projectId` integer
      - `spaceId` integer
      - `projectName` string
      - `spaceName` string
      - `subTaskCount` integer
      - `parentCommentCount` integer
      - `customFields` TaskCustomFieldDto[]
        - `tenantId` integer
        - `taskCustomFieldId` integer
        - `fieldName` string
        - `description` string
        - `fieldType` string
        - `fieldValue` TaskFieldValue[]
          - `taskId` integer
          - `value` unknown
        - `fieldIcon` string
        - `spaceId` integer
        - `projectId` integer
        - `associatedId` integer
        - `level` 'ORG' | 'SPACE' | 'LOCAL'
        - `active` boolean
        - `order` integer
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `modifiedBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `createdTime` string, date-time
        - `modifiedTime` string, date-time
        - `options` CustomFieldOptionDto[]
          - `optionId` integer
          - `optionName` string, required
          - `color` string
          - `spaceId` integer
          - `projectId` integer
          - `taskCustomFieldId` integer
      - `blockedByTasks` TaskDependencyDto[]
        - `tenantId` integer
        - `dependencyId` integer
        - `spaceId` integer
        - `projectId` integer
        - `dependencyType` string
        - `blocking` TaskResponseDto
          - `taskId` integer
          - `projectId` integer
          - `spaceId` integer
          - `taskTitle` string
          - `status` TaskStatusDto
            - `tenantId` integer
            - `taskStatusId` integer
            - `statusName` string
            - `color` string
            - `statusCategory` string
            - `projectId` integer
            - `spaceId` integer
            - `createdBy` UserMinimalDto
              - …
            - `modifiedBy` UserMinimalDto
              - …
            - `default` boolean
            - `primary` boolean
          - `dueDate` string, date-time
          - `owners` UserMinimalDto[]
            - `userId` integer
            - `firstName` string
            - `email` string
            - `profilePicURL` string
            - `profilePicColor` string
            - `provider` string
            - `role` OrgRoleDto
              - …
          - `isInternal` boolean
        - `blockedBy` TaskResponseDto
          - `taskId` integer
          - `projectId` integer
          - `spaceId` integer
          - `taskTitle` string
          - `status` TaskStatusDto
            - `tenantId` integer
            - `taskStatusId` integer
            - `statusName` string
            - `color` string
            - `statusCategory` string
            - `projectId` integer
            - `spaceId` integer
            - `createdBy` UserMinimalDto
              - …
            - `modifiedBy` UserMinimalDto
              - …
            - `default` boolean
            - `primary` boolean
          - `dueDate` string, date-time
          - `owners` UserMinimalDto[]
            - `userId` integer
            - `firstName` string
            - `email` string
            - `profilePicURL` string
            - `profilePicColor` string
            - `provider` string
            - `role` OrgRoleDto
              - …
          - `isInternal` boolean
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `createdTime` string, date-time
      - `blockingTasks` TaskDependencyDto[]
        - `tenantId` integer
        - `dependencyId` integer
        - `spaceId` integer
        - `projectId` integer
        - `dependencyType` string
        - `blocking` TaskResponseDto
          - `taskId` integer
          - `projectId` integer
          - `spaceId` integer
          - `taskTitle` string
          - `status` TaskStatusDto
            - `tenantId` integer
            - `taskStatusId` integer
            - `statusName` string
            - `color` string
            - `statusCategory` string
            - `projectId` integer
            - `spaceId` integer
            - `createdBy` UserMinimalDto
              - …
            - `modifiedBy` UserMinimalDto
              - …
            - `default` boolean
            - `primary` boolean
          - `dueDate` string, date-time
          - `owners` UserMinimalDto[]
            - `userId` integer
            - `firstName` string
            - `email` string
            - `profilePicURL` string
            - `profilePicColor` string
            - `provider` string
            - `role` OrgRoleDto
              - …
          - `isInternal` boolean
        - `blockedBy` TaskResponseDto
          - `taskId` integer
          - `projectId` integer
          - `spaceId` integer
          - `taskTitle` string
          - `status` TaskStatusDto
            - `tenantId` integer
            - `taskStatusId` integer
            - `statusName` string
            - `color` string
            - `statusCategory` string
            - `projectId` integer
            - `spaceId` integer
            - `createdBy` UserMinimalDto
              - …
            - `modifiedBy` UserMinimalDto
              - …
            - `default` boolean
            - `primary` boolean
          - `dueDate` string, date-time
          - `owners` UserMinimalDto[]
            - `userId` integer
            - `firstName` string
            - `email` string
            - `profilePicURL` string
            - `profilePicColor` string
            - `provider` string
            - `role` OrgRoleDto
              - …
          - `isInternal` boolean
        - `createdBy` UserMinimalDto
          - `userId` integer
          - `firstName` string
          - `email` string
          - `profilePicURL` string
          - `profilePicColor` string
          - `provider` string
          - `role` OrgRoleDto
            - `orgRoleId` integer
            - `roleName` string
        - `createdTime` string, date-time
      - `parent` boolean
      - `internal` boolean
      - `recurring` boolean
      - `isInternal` boolean
    - `hasMore` boolean
  - `timestamp` string, date-time — Timestamp of the response

---

[API](https://skmtc.net/astravue/apis/astravue-api.md) · [All operations](https://skmtc.net/astravue/apis/astravue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astravue/astravue-api/versions/237f5bbd4029/schema)