---
title: "List legal holds"
method: GET
path: "/apiops/projects/{projectName}/legal-holds"
tags: ["LegalHold"]
---

# List legal holds

`GET /apiops/projects/{projectName}/legal-holds`

## Request

- Base URL: `http://167.86.118.166:32080`
- URL: `http://167.86.118.166:32080/apiops/projects/{projectName}/legal-holds`
- Auth: none declared
- TypeScript: <https://skmtc.dev/apinizer/apis/apinizer-management-apis/docs/apiops/projects/:projectName/legal-holds/get.ts> (a function with typed inputs; its response is checked against the schema)

The project's holds, newest first. Narrow with status (ACTIVE / RELEASED) and with a subject; a subjectKey requires its subjectType.

## Path parameters

- `projectName` string, required

## Query parameters

- `status` string
- `subjectType` 'ORGANIZATION' | 'CONSUMER' | 'APPLICATION' | 'API_CLIENT'
- `subjectKey` string
- `page` integer
- `size` integer

## Response `200`

OK

- ApiOpsPagedResponseApiOpsResponseLegalHold
  - `status` 'SUCCESS' | 'FAILURE'
  - `items` ApiOpsResponseLegalHold[]
    - `holdId` string
    - `subjectType` 'ORGANIZATION' | 'CONSUMER' | 'APPLICATION' | 'API_CLIENT'
    - `subjectKey` string
    - `status` string
    - `reason` string
    - `reference` string
    - `placedBy` string
    - `placedAt` string, date-time
    - `releasedBy` string
    - `releasedAt` string, date-time
    - `releaseReason` string
  - `page` integer
  - `size` integer
  - `totalElements` integer
  - `totalPages` integer
  - `sort` string[]

---

[API](https://skmtc.dev/apinizer/apis/apinizer-management-apis.md) - [All operations](https://skmtc.dev/apinizer/apis/apinizer-management-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/apinizer/apis/apinizer-management-apis/revisions/e083046b24cd?raw)