---
title: "Get List of Subtasks by Request"
method: GET
path: "/api/datasubject/v2/requestqueues/{requestQueueRefId}/subtasks"
tags: ["Subtasks"]
---

# Get List of Subtasks by Request

`GET /api/datasubject/v2/requestqueues/{requestQueueRefId}/subtasks`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/datasubject/v2/requestqueues/{requestQueueRefId}/subtasks`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `DSAR`, `DSAR_READ`, `DSAR_WRITE`

Use this API to retrieve a list of all subtasks associated with a specific request. The response will include details for each subtask along with the request approver, date created, and deadline.

## Path parameters

- `requestQueueRefId` string, required: Request queue reference Id

## Query parameters

- `page` integer
- `size` integer

## Response `200`

OK

- PrivacyAutomationDataSubjectRequestDSRAutomationSubTaskListV2Dto[]
  - `requestApprover` string: Approver of the parent request
  - `requestQueueRefId` string: The request reference ID
  - `requestOrgName` string: Organization name of the request
  - `subTaskStatus` string: Current status of the subtask
  - `subTaskType` string: Type of the subtask
  - `subTaskName` string: Name of the subtask
  - `subTaskDescription` string: Description of the subtask
  - `subTaskAssignee` string: Person assigned to the subtask
  - `subTaskRequired` boolean: Whether the subtask is required
  - `requestQueueDateCreated` string, date-time: Date when the parent request was created
  - `requestQueueDeadline` string, date-time: Deadline for the parent request
  - `subTaskCreatedDate` string, date-time: Date when the subtask was created
  - `subTaskLastUpdatedDate` string, date-time: Date when the subtask was last updated
  - `subTaskReminderDate` string, date-time: Reminder date for the subtask
  - `subTaskDeadline` string, date-time: Deadline for the subtask
  - `requestTypes` string[]: Types of the parent request
  - `subjectTypes` string[]: Subject types of the parent request
  - `subTaskResolution` string: Resolution code for the subtask if completed or rejected
  - `requestQueueId` string, uuid
  - `assignedToGroup` boolean
  - `subTaskId` string, uuid

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/onetrust/apis/privacy-automation-data-subject-request-dsr-automation.md) - [All operations](https://skmtc.dev/onetrust/apis/privacy-automation-data-subject-request-dsr-automation/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/privacy-automation-data-subject-request-dsr-automation/revisions/612f0b39b904?raw)