---
title: "Privacy request"
method: POST
path: "/privacy/requests"
tags: ["Data Privacy"]
---

# Privacy request

`POST /privacy/requests`

In compliance with privacy laws, request access or deletion of customer data on behalf of the customer. 
This endpoint should only be used if a data subject has specifically asked that their personal data be accessed or deleted, and their identity has been verified. 
The response will include a unique ID assigned to this request.

## Headers

- `api-version` string, required
- `x-forter-siteid` string, required
- `Authorization` string, required

## Request body

- PrivacyRequestRequest — In compliance with privacy laws, request access or deletion of customer data on behalf of the customer. This endpoint should only be used if a data subject has specifically asked that their personal data be accessed or deleted, and their identity has been verified. The response will include a unique ID assigned to this request.
  - `identifier` Identifier, required — An object that represents identifier of a data subject for the privacy requests purposes.
    - `type` 'EMAIL', required — Type of identifier
    - `value` string, required — Identifier value
  - `requestType` 'DELETE' | 'ACCESS', required — Type of this privacy request

## Response `200`

Example privacyResponse

- PrivacyResponse — Response object for creation of a new privacy request.
  - `requestUniqueId` string, required — A Forter unique identifier that was assigned to a privacy request. It can be used to retrieve the status information and download the output data in case of an access request.

## Other responses

- `400` — Bad Request (Often missing a required parameter)
- `401` — Unauthorized (No valid API key provided)
- `404` — Not Found (The requested item doesn't exist)
- `429` — Too Many Requests (The client exceeded a rate limit). Honor Retry-After before retrying.
- `500` — Server Error (Something went wrong on Forter's end)
- `default` — Typed error envelope for any undeclared 4xx / 5xx status.

---

[API](https://skmtc.net/forter/apis/forter-api.md) · [All operations](https://skmtc.net/forter/apis/forter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/forter/forter-api/revisions/d7b02e919b34/schema)