---
title: "Get Request Audit History"
method: GET
path: "/api/datasubject/v2/requestqueues/{requestQueueRefId}/requesthistory"
tags: ["Request Queues"]
---

# Get Request Audit History

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

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/datasubject/v2/requestqueues/{requestQueueRefId}/requesthistory`
- 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 the audit history of a request. The response will include details such as field updates and the date and time when changes were made.

## Path parameters

- `requestQueueRefId` string, required: 10-character ID that is unique to each request. This ID can be obtained either from the response of the GET /requestqueues/{language} api or by navigating to the Requests section within the DSAR module in the application

## Query parameters

- `page` integer: Results page you want to retrieve. Page number starts with 0 (0..N)
- `size` integer: Number of records per page.

## Response `200`

OK

- PrivacyAutomationDataSubjectRequestDSRAutomationRequestAuditInfoResponse[]
  - `description` string: The description of the request attribute audited.
  - `changeDateTime` string, date-time: The timestamp when the change was done.
  - `recordedDateTime` string, date-time: The timestamp when the audit was recorded.
  - `userDetail` PrivacyAutomationDataSubjectRequestDSRAutomationBasicTenantUserInfoResponse
    - `email` string
    - `fullName` string
    - `userId` string, uuid
    - `internal` boolean
    - `disabled` boolean
    - `deleted` boolean
  - `changes` PrivacyAutomationDataSubjectRequestDSRAutomationAuditRecordDetail[]
    - `description` string: The description of the request attribute audited.
    - `fieldName` string: The name of the request attribute audited.
    - `oldValue` PrivacyAutomationDataSubjectRequestDSRAutomationAuditFieldValue
      - `name` string
    - `newValue` PrivacyAutomationDataSubjectRequestDSRAutomationAuditFieldValue
      - `name` string

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