Sign in

v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB
Subtasks

Get List of Subtasks

❗️ End of Support Notification

As of January 1, 2026, this API is now deprecated. Any customers leveraging this API are encouraged to use the Get List of Subtasks by Criteria API. For more information, see OneTrust API Sunsetting & Deprecation Guidelines.

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

🗒 Things to Know

  • This API does not return subtasks in Complete status.
get/api/datasubject/v2/subtasks

Query parameters

languagestring

A language code that identifies the language in which the Request Type and Subject Type values should be returned, assuming translations are available for that language. Examples: language=en-us for English, language=de for German, language=es for Spanish, etc.

modifieddatestring date

A date (yyyyMMdd). Include to retrieve a list of subtasks modified on or after the specified date. For example, if you want to retrieve subtasks modified on or after January 30, 2019, include the modifieddate=20190130 parameter in your query.

statusstring

To get a SubTasks according to Status. Examples: status=assigned

openrequestsboolean

An optional parameter to show subtasks on open requests if set to true.if this parameter is set to false or omitted, the response will contain subtasks on all requests Examples: openrequests=true

pageinteger

Results page you want to retrieve. Page number starts with 0 (0..N)

sizeinteger

Number of records per page. Maximum page size allowed is 500

sort'taskName,asc' | 'taskName,desc' | 'createdDate,asc' | 'createdDate,desc' | 'lastModifiedDate,asc' | 'lastModifiedDate,desc'

Sorting criteria in the format: property(,asc|desc). Default sort order is ascending.

Response

OK

requestApproverstring

Approver of the parent request

requestQueueRefIdstring

The request reference ID

requestOrgNamestring

Organization name of the request

subTaskStatusstring

Current status of the subtask

subTaskTypestring

Type of the subtask

subTaskNamestring

Name of the subtask

subTaskDescriptionstring

Description of the subtask

subTaskAssigneestring

Person assigned to the subtask

subTaskRequiredboolean

Whether the subtask is required

requestQueueDateCreatedstring date-time

Date when the parent request was created

requestQueueDeadlinestring date-time

Deadline for the parent request

subTaskCreatedDatestring date-time

Date when the subtask was created

subTaskLastUpdatedDatestring date-time

Date when the subtask was last updated

subTaskReminderDatestring date-time

Reminder date for the subtask

subTaskDeadlinestring date-time

Deadline for the subtask

requestTypesstring[]

Types of the parent request

subjectTypesstring[]

Subject types of the parent request

subTaskResolutionstring

Resolution code for the subtask if completed or rejected

requestQueueIdstring uuid
assignedToGroupboolean
subTaskIdstring uuid

Example response

[
  {
    "requestApprover": "John Doe",
    "requestQueueRefId": "SL244HWD6D",
    "requestOrgName": "Example Organization",
    "subTaskStatus": "OPEN",
    "subTaskType": "MANUAL",
    "subTaskName": "Data Discovery",
    "subTaskDescription": "Discover all data related to the subject",
    "subTaskAssignee": "Jane Smith",
    "subTaskRequired": true,
    "requestQueueDateCreated": "2023-08-01T10:15:30Z",
    "requestQueueDeadline": "2023-09-01T10:15:30Z",
    "subTaskCreatedDate": "2023-08-02T14:30:45Z",
    "subTaskLastUpdatedDate": "2023-08-15T09:20:15Z",
    "subTaskReminderDate": "2023-08-25T10:15:30Z",
    "subTaskDeadline": "2023-09-01T10:15:30Z",
    "requestTypes": [
      "Data Portability",
      "Update Data"
    ],
    "subjectTypes": [
      "Customer",
      "Employee"
    ],
    "subTaskResolution": "Completed Successfully"
  }
]