---
title: "List legal hold policies associated with a user - v3"
method: POST
path: "/legalholds/v3/users/policies"
tags: ["Legal Hold"]
---

# List legal hold policies associated with a user - v3

`POST /legalholds/v3/users/policies`

## Request

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

Returns the list of legal hold policies that are associated with a user.

## Request body

- RequestListPoliciesByUsers
  - `custodians` object[]
    - `emailId` string: Email address of the user for which the associated legal hold policies are requested. Example - ernie.carter@druva.com
  - `action` 'list'

## Response `200`

OK

- ResponseListPoliciesByUsers
  - `custodians` object[]
    - `emailId` string: Email address of the user for which the associated legal hold policies are requested. Example - ernie.carter@druva.com
    - `policyIds` integer[]

## Other responses

- `400`: Bad Request
- `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)