---
title: "Get List of DROP Records"
method: POST
path: "/api/drop-manager/v1/drops"
tags: ["DROP Management"]
---

# Get List of DROP Records

`POST /api/drop-manager/v1/drops`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/drop-manager/v1/drops`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `DSAR_READ`, `DSAR_WRITE`

Use this API to retrieve a list of DROP records by the specified filter criteria. The response will include details such as the DROP record identifier, created date, and DSAR request ID.

## Query parameters

- `page` integer
- `size` integer
- `sort` 'dateCreated,asc' | 'dateCreated,desc' | 'dateUpdated,asc' | 'dateUpdated,desc'

## Request body

- PrivacyAutomationDROPManagementDropListFilterRequest
  - `filterCriteria` PrivacyAutomationDROPManagementDropListFilterCriterion[]: List of filter criteria to apply. Each criterion targets a single attribute.
    - `attributeKey` 'status' | 'dateCreated' | 'dateUpdated' | 'source' | 'batchName', required: Attribute to filter on.
    - `operator` 'EQ' | 'NE' | 'GT' | 'LT' | 'BETWEEN', required: Comparison operator to apply.
    - `fromValue` object, required: Value or list of values to filter by. Format depends on attributeKey.
    - `toValue` object: End value for range operators such as BETWEEN. Format depends on attributeKey.

## Response `200`

OK

- PrivacyAutomationDROPManagementPageDropListResponse
  - `totalElements` integer
  - `totalPages` integer
  - `size` integer
  - `content` PrivacyAutomationDROPManagementDropListResponse[]
    - `id` string, uuid: UUID primary key of the DROP record.
    - `dropId` string: DROP record identifier (dropId).
    - `hash` string: Hashed identifier of the data subject.
    - `hashType` string: Type of the hashed identifier.
    - `dateCreated` string, date-time: Date and time when the DROP record was created.
    - `dateUpdated` string, date-time: Date and time when the DROP record was last updated.
    - `dataType` string: Type of data represented by the DROP record.
    - `dsarRequestId` string, uuid: UUID of the associated data-subject access request.
    - `batchName` string: Name of the upload batch the DROP record belongs to.
    - `source` string: Source of the DROP record.
    - `status` 'PENDING' | 'EXEMPTED' | 'DELETED' | 'OPTED_OUT' | 'NOT_FOUND': Current status of the DROP record.
  - `number` integer
  - `sort` PrivacyAutomationDROPManagementSortObject
    - `empty` boolean
    - `unsorted` boolean
    - `sorted` boolean
  - `first` boolean
  - `last` boolean
  - `numberOfElements` integer
  - `pageable` PrivacyAutomationDROPManagementPageableObject
    - `offset` integer
    - `sort` PrivacyAutomationDROPManagementSortObject
      - `empty` boolean
      - `unsorted` boolean
      - `sorted` boolean
    - `paged` boolean
    - `pageSize` integer
    - `pageNumber` integer
    - `unpaged` boolean
  - `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)