---
title: "Get List of Requests"
method: GET
path: "/api/datasubject/v2/requestqueues/{language}"
tags: ["Request Queues"]
---

# Get List of Requests

`GET /api/datasubject/v2/requestqueues/{language}`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/datasubject/v2/requestqueues/{language}`
- 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 requests. The response will include details for each request along with the approver, date created, and data subject's first and last name.

## Path parameters

- `language` string, required: A language code that identifies the language in which the request data should be returned, assuming translations are available for that language. Examples: en-us for English, de for German, fr for French, etc.

## Query parameters

- `modifieddate` string, date: A date (yyyyMMdd). Include to retrieve a list of requests modified on or after the specified date. For example, if you want to retrieve requests modified on or after January 30, 2019, include the modifieddate=20190130 parameter in your query.
- `createddate` string, date: A date (yyyyMMdd). Include to retrieve a list of requests created on or after the specified date. For example, if you want to retrieve requests created on or after January 30, 2019, include the createddate=20190130 parameter in your query.
- `status` string: Filter requests by stage name. Parameters must be URL encoded.
- `ignoreUserRequests` boolean: A flag to exclude requests associated with user if they are not associated with specified organization.
- `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` string: Sorting criteria in the format: property(,asc|desc). Default sort order is ascending.

## Response `200`

OK

- PrivacyAutomationDataSubjectRequestDSRAutomationRequestQueueV2Dto[]
  - `requestQueueRefId` string: Reference ID of the request. This is a 10-character ID that is unique to each request.
  - `requestQueueId` string, uuid: The request GUID
  - `firstName` string: First name of the data subject.
  - `lastName` string: Last name of the data subject.
  - `organization` string: Organization to which this request is assigned.
  - `status` string: Current stage of the request. Various stages in the order of progression are: New, Verifying identity, In progress, Rejected, Complete.
  - `requestTypes` string[]: Request types selected while submitting the request.
  - `deadline` string, date-time: Deadline for the request.
  - `isExtended` boolean: Returns true if the request complete time is being extended.
  - `dateCreated` string, date-time: Date on which request is submitted.
  - `dateUpdated` string, date-time: Last activity date on the request.
  - `subjectTypes` string[]: Subject types selected while submitting the request. Subject type can be: Prospective Employee, Student, Customer, Contractor, Employee, Patient.
  - `approver` string: Approver or assignee for the request.
  - `language` string: Language in which the request is created.
  - `countryCode` string: The code for the country as per ISO 3166. e.g. US for the United States, DE for Germany.
  - `countryName` string: Name of the country.
  - `email` string: Email provided while submitting the request.
  - `workflow` string: Name of the request workflow.
  - `webform` string: Name of the webform.
  - `dateCompleted` string, date-time: Date on which the request is completed.
  - `resolution` string: Resolution selected if the request is rejected.
  - `remainingDaysForMaxDeadline` integer: Legal Deadline + Maximum Number of Extension Days based on country of request + Total Pause days.
  - `maxDeadlineExtensionDate` string, date-time: Legal Deadline + Maximum Number of Extension Days based on country of request + Total Pause days.
  - `assignedToGroup` boolean: Indicates if the request reviewer is assigned to a usergroup or not.
  - `additionalStatuses` '0' | '10': Status of the request timer, such as PAUSED or ACTIVE.
  - `legalDeadLineInfo` PrivacyAutomationDataSubjectRequestDSRAutomationRequestQueueListDto
    - `firstName` string
    - `lastName` string
    - `email` string
    - `requestQueueId` string, uuid
    - `requestQueueRefId` string
    - `orgGroupId` string, uuid
    - `daysLeft` integer
    - `status` integer
    - `dateCreated` string, date-time
    - `isExtended` boolean
    - `reviewer` string
    - `reviewerId` string, uuid
    - `language` string
    - `templateId` string, uuid
    - `currentStage` string
    - `requestTypes` string[]
    - `subjectTypes` string[]
    - `deadline` string, date-time
    - `workflowDetailDto` PrivacyAutomationDataSubjectRequestDSRAutomationRequestQueueWorkflowDetailDto
      - `stage` string
      - `allowRequestQueueUpdate` boolean
      - `beginDeadlineCalc` boolean
      - `allowDeadlineEdit` boolean
    - `totalSubtasks` integer
    - `completedSubtasks` integer
    - `remainingSubtasks` integer
    - `dsLanguageName` string
    - `webformName` string
    - `workflowName` string
    - `workflowReferenceId` string, uuid
    - `resolution` string
    - `lastUpdated` string, date-time
    - `authEnabled` boolean
    - `lastPublicCommentDate` string, date-time
    - `lastDSReplyDate` string, date-time
    - `state` string
    - `country` string
    - `closureDate` string, date-time
    - `countryCode` string
    - `webFormVersion` integer
    - `remainingDaysForMaxDeadline` integer
    - `numberOfLinkedRequests` integer
    - `maxDeadlineExtensionDate` string, date-time
    - `selectFields` object
      - `all` object
      - `empty` boolean
    - `inputFields` object
    - `totalDataCount` integer
    - `retentionStatus` integer
    - `resultsSummaryDataCount` PrivacyAutomationDataSubjectRequestDSRAutomationResultsSummaryDataCountDto
      - `dataPoints` integer
      - `unstructuredData` integer
      - `attachments` integer
      - `excluded` integer
    - `slaExceeded` string
    - `visited` boolean
    - `attentionRequired` boolean
    - `seededOtherData` object
    - `lastDsAccessDate` string, date-time
    - `assignedTogroup` boolean
    - `additionalStatuses` '0' | '10'
    - `daysPaused` number, double
    - `dsAccessRevoked` boolean
    - `testRequest` boolean
    - `taskMode` boolean

## 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)