---
title: "Delete Data Subject"
method: DELETE
path: "/rest/api/consent/v4/data-subjects"
tags: ["Data Subjects V4"]
---

# Delete Data Subject

`DELETE /rest/api/consent/v4/data-subjects`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/rest/api/consent/v4/data-subjects`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `CONSENT`

Initiates a TTL-based deletion process for a data subject

## Request body

- ConsentAPIDataSubjectDeleteRequestV4
  - `identifier` string, required: The data subject identifier of the data subject.
  - `retainReceipts` boolean, required: This flag indicates whether receipts will be retained while deleting data subjects. When set to `false`, receipts are removed from the database and no longer appear in the OneTrust Platform UI. However, these receipts are not permanently deleted and can still be retrieved using the [Get List of Receipts API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost).

## Response `200`

Deletion Request using TTL has been accepted

## Other responses

- `400`: Missing retainReceipts flag in the request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Unable to find a datasubject with given identifier
- `422`: Missing identifier(or)additionalidentifier in the request
- `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/consent-preferences-universal-consent-preference-management.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/revisions/fe4a0697ec9d?raw)