---
title: "Get List of Subtasks by Criteria"
method: POST
path: "/api/datasubject/v3/subtasks"
tags: ["Subtasks"]
---

# Get List of Subtasks by Criteria

`POST /api/datasubject/v3/subtasks`

Use this API to retrieve a list of all subtasks by filter criteria.

## Query parameters

- `includeClosedSubtasks` boolean — Include closed subtasks in the response
- `onlyActivatedSubtasks` boolean — Only include activated subtasks in the response
- `page` integer — Results page you want to retrieve. Page number starts with 0 (0..N)
- `size` integer — Number of records per page. Maximum page size allowed is 500
- `sort` 'requestTypeName,asc' | 'requestTypeName,desc' | 'subjectTypeName,asc' | 'subjectTypeName,desc' | 'taskName,asc' | 'taskName,desc' | 'subtaskDateCreated,asc' | 'subtaskDateCreated,desc' | 'subtaskDateUpdated,asc' | 'subtaskDateUpdated,desc' | 'requestDeadline,asc' | 'requestDeadline,desc' | 'requestDateCreated,asc' | 'requestDateCreated,desc' — Sorting criteria in the format: property(,asc|desc). Default sort order is subTaskId ascending.

## Request body

- PrivacyAutomationDataSubjectRequestDSRAutomationSubTaskV3RequestDto
  - `RequestType` string — Filter subtasks by Request Type. Only subtasks belonging to requests with this Request Type will be retrieved.
  - `SubjectType` string — Filter subtasks by Subject Type. Only subtasks belonging to requests with this Subject Type will be retrieved.
  - `Organization` string — Filter subtasks by Organization. Subtasks in this organization and related child organizations will be retrieved if includeChildOrgs is true.
  - `SystemName` string — Filter subtasks by integration system name. Only system subtasks associated with this system will be returned.
  - `SubtaskStatus` string[]
  - `SubtaskType` 'manual' | 'system' — Filter subtasks by type - either 'manual' for user-created subtasks or 'system' for automated system subtasks.
  - `OpenRequests` boolean — When set to true, only subtasks belonging to open requests will be included in the results. If false or omitted, subtasks from both open and closed requests will be returned.
  - `SubtaskDateCreated` PrivacyAutomationDataSubjectRequestDSRAutomationDateRangeDto
    - `StartDate` string — Start date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
    - `EndDate` string — End date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
  - `SubtaskDateUpdated` PrivacyAutomationDataSubjectRequestDSRAutomationDateRangeDto
    - `StartDate` string — Start date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
    - `EndDate` string — End date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
  - `RequestDeadline` PrivacyAutomationDataSubjectRequestDSRAutomationDateRangeDto
    - `StartDate` string — Start date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
    - `EndDate` string — End date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
  - `RequestDateCreated` PrivacyAutomationDataSubjectRequestDSRAutomationDateRangeDto
    - `StartDate` string — Start date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
    - `EndDate` string — End date for filter, provide in yyyy-MM-dd'T'HH:mm:ss.SSS'Z' format
  - `currentRequestStage` string[] — Filter subtasks by current request stage. Accepted values include: All default and custom request stages are supported.
  - `subtaskCreatedStage` string[] — Filter subtasks by subtask created stage. Accepted values include: All default and custom request stages are supported.
  - `language` string — Specifies the language code for localized field values in the response. Translations will be provided for this language if available.
  - `IncludeChildOrgs` boolean — By default set to true if omitted. On true Subtasks of Child Organizations of the given Organization will be included.On False Subtasks of the given Organization will be included. Effective only if 'organization' value is provided.
  - `ExactSystemNameMatch` boolean — When set to true, performs exact match for SystemName instead of substring matching. This ensures only subtasks from systems with exact name match are returned. By default set to false for backward compatibility.

## Response `200`

OK

- PrivacyAutomationDataSubjectRequestDSRAutomationSubTaskV3Dto[]
  - `assignedToGroup` boolean — Indicates whether the subtask is assigned to a group rather than an individual.
  - `requestApprover` string — The name of the person who approved the parent request.
  - `requestOrgName` string — The organization name associated with the request.
  - `requestQueueDateCreated` string, date-time — The date when the parent request was created.
  - `requestQueueDeadline` string, date-time — The deadline for the parent request.
  - `requestQueueId` string, uuid — The request unique ID
  - `requestQueueRefId` string — The request reference ID
  - `requesterEmail` string, email — The email address of the requester
  - `subTaskAssignee` string — The person assigned to the subtask
  - `subTaskCreatedDate` string, date-time — The date when the subtask was created
  - `subTaskDeadline` string, date-time — The deadline for the subtask
  - `subTaskDescription` string — The description of the subtask
  - `subTaskId` string, uuid — The subtask unique ID
  - `subTaskLastUpdatedDate` string, date-time — The date when the subtask was last updated
  - `subTaskName` string — The name of the subtask
  - `subTaskReminderDate` string, date-time — The reminder date for the subtask
  - `subTaskRequired` boolean — Indicates whether the subtask is required
  - `subTaskStatus` 'OPEN' | 'ASSIGNED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'READY_FOR_REVIEW' | 'PROCESSING' | 'NOT_RUN' — The current status of the subtask
  - `subTaskType` 'MANUAL' | 'SYSTEM_TASK' — The type of the subtask
  - `subTaskResolution` string — The resolution code for the subtask if completed or rejected
  - `requestTypes` string[] — Types of the parent request
  - `subjectTypes` string[] — Subject types of the parent request
  - `currentRequestStage` string — The current stage of the parent request
  - `subtaskCreatedStage` string — The stage when the subtask was created

## 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.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)