GRgranola

List legal holds

Changed on

Lists every legal hold in your workspace, newest first. Released holds are returned alongside active ones, each carrying released_at.

get/v1/legal-holds

Request

  • Base URL
    https://public-api.granola.ai
  • Auth
    HTTP bearer

Query parameters

cursorstring

The cursor to continue from

Example:eyJjcmVkZW50aWFsfQ==
page_sizeinteger

Maximum number of legal holds to return per page

Example:10

Response

List of legal holds

hasMoreboolean required

Whether there are more legal holds to fetch. A page can hold fewer than page_size holds and still not be the last one, so page on this and cursor.

cursorstring nullable required

The cursor to continue from

Example response

{
  "legal_holds": [
    {
      "id": "lgh_Abc123XyZ456De",
      "object": "legal_hold",
      "name": "X v. Y",
      "description": "Preservation notice 2026-08-12",
      "custodian_count": 3,
      "created_at": "2026-09-21T10:00:00Z"
    }
  ]
}

Changes