---
title: "List legal hold custodians"
method: GET
path: "/v1/legal-holds/{hold_id}/custodians"
---

# List legal hold custodians

`GET /v1/legal-holds/{hold_id}/custodians`

## Request

- Base URL: `https://public-api.granola.ai`
- URL: `https://public-api.granola.ai/v1/legal-holds/{hold_id}/custodians`
- Auth: HTTP bearer

Lists the users a hold names, oldest first. Removed custodians are returned alongside active ones, each carrying `removed_at`.

## Path parameters

- `hold_id` string, required: The legal hold id. Case-insensitive.

## Query parameters

- `cursor` string: The cursor to continue from
- `page_size` integer: Maximum number of custodians to return per page

## Response `200`

List of custodians

- ListLegalHoldCustodiansOutput
  - `custodians` LegalHoldCustodian[], required
    - `id` string, required: The unique identifier for the custodian entry
    - `object` 'legal_hold_custodian', required: The type of object
    - `user` object, required: The person this custodian entry names. `email` is null once their Granola account has been deleted.
      - `object` 'user', required
      - `id` string, required
      - `email` string, email, nullable, required
    - `added_at` string, date-time, required: When this person was named by the hold
    - `removed_at` string, date-time, nullable, required: When this person was removed from the hold, or null while they are named. Removed custodians are always returned, so the record of who was held survives.
  - `hasMore` boolean, required: Whether there are more custodians to fetch. A page can hold fewer than `page_size` custodians and still not be the last one, so page on this and `cursor`.
  - `cursor` string, nullable, required: The cursor to continue from

## Other responses

- `400`: Bad request or invalid cursor
- `401`: Unauthorized - Invalid API key
- `404`: Not found

## Changes

- **2026-10-19** `480617fbc624`: 1 warning
  - changed the pattern of the `path` request parameter `hold_id` from `^lgh_[a-zA-Z0-9]{14}$` to `^[Ll][Gg][Hh]_[a-zA-Z0-9]{14}$`
- **2026-09-26** `58997a2621d6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/granola/apis/granola-api/changes/v1/legal-holds/:hold_id/custodians/get.md)

---

[API](https://skmtc.dev/granola/apis/granola-api.md) - [All operations](https://skmtc.dev/granola/apis/granola-api/llms.txt) - [OpenAPI document](https://skmtc.dev/granola/apis/granola-api/revisions/24329b15cdfe?raw)