---
title: "Search Requests"
method: POST
path: "/api/datasubject/v2/requestqueues/search/{language}"
tags: ["Request Queues"]
---

# Search Requests

`POST /api/datasubject/v2/requestqueues/search/{language}`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/datasubject/v2/requestqueues/search/{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 search for requests by key terms, such as the data subject’s first name, last name, email address, or request ID.

## Path parameters

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

## Query parameters

- `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.
- `page` integer: Results page you want to retrieve. Page number starts with 0 (0..N)
- `size` integer: Number of records per page.

## Request body

- PrivacyAutomationDataSubjectRequestDSRAutomationSearchV2Request
  - `term` string

## Response `200`

OK

- PrivacyAutomationDataSubjectRequestDSRAutomationSearchResultPage
  - `content` object[]
  - `pageable` PrivacyAutomationDataSubjectRequestDSRAutomationPageableObject
    - `offset` integer
    - `sort` PrivacyAutomationDataSubjectRequestDSRAutomationSortObject
      - `empty` boolean
      - `sorted` boolean
      - `unsorted` boolean
    - `paged` boolean
    - `pageSize` integer
    - `pageNumber` integer
    - `unpaged` boolean
  - `searchTime` integer
  - `totalTime` integer
  - `searchTerms` object
  - `last` boolean
  - `totalElements` integer
  - `totalPages` integer
  - `size` integer
  - `number` integer
  - `sort` PrivacyAutomationDataSubjectRequestDSRAutomationSortObject
    - `empty` boolean
    - `sorted` boolean
    - `unsorted` boolean
  - `first` boolean
  - `numberOfElements` integer
  - `empty` 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)