---
title: "List legal hold policies - v3"
method: GET
path: "/legalholds/v3/policies"
tags: ["Legal Hold"]
---

# List legal hold policies - v3

`GET /legalholds/v3/policies`

## Request

- Base URL: `https://apis.druva.com/insync`
- URL: `https://apis.druva.com/insync/legalholds/v3/policies`
- Auth: API key in header `Authorization`

Returns a list of all the Legal Hold policies that are configured in Druva inSync.

## Response `200`

OK

- ListLegalholds
  - `legalholdList` object[]
    - `type` 'All Backup Data' | 'Last Backup Data' | 'Data within a Date Range': The data access type of the legal hold policy
    - `name` string: The name of the legal hold policy
    - `policyId` integer: The ID of the legal hold policy
    - `cullingType` 'Include All Files' | 'Include Only Deleted Files': The filter type of the legal hold policy. :fa-info-circle: Applicable only if the data access type is 'Data within a Date Range'.
    - `startDate` string, date: The start date in the range in which the data is to be accessed. Format: YYYY-MM-DD :fa-info-circle: Applicable only if the data access type is 'Data within a Date Range'.
    - `endDate` string, date: The end date in the range in which the data is to be accessed. Format: YYYY-MM-DD :fa-info-circle: Applicable only if the data access type is 'Data within a Date Range'.

## Other responses

- `401`: Unauthorized
- `403`: Access denied: Insufficient permissions. User requires specific access rights and minimum permissions. Details: https://help.druva.com/en/articles/15069296
- `404`: Not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/druva/apis/insync-cloud.md) - [All operations](https://skmtc.dev/druva/apis/insync-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/insync-cloud/revisions/a0ce6d05033c?raw)