---
title: "List disposal holds"
method: GET
path: "/api/v2/disposal/holds"
tags: ["v2 disposal holds"]
---

# List disposal holds

`GET /api/v2/disposal/holds`

## Response `200`

Returns a list of disposal holds

- DisposalHolds
  - `disposalHolds` DisposalHold[]
    - `id` string
    - `title` string
    - `description` string
    - `mandate` string
    - `scopeNotes` string
    - `createdOn` string, date-time
    - `createdBy` string
    - `updatedOn` string, date-time
    - `updatedBy` string
    - `originatedOn` string, date-time
    - `originatedBy` string
    - `liftedOn` string, date-time
    - `liftedBy` string
    - `firstTimeUsed` string, date-time
    - `aipCounter` integer
    - `state` 'ACTIVE' | 'LIFTED'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/keeps/apis/roda-rest-api.md) · [All operations](https://skmtc.net/keeps/apis/roda-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keeps/roda-rest-api/revisions/afc3c5bcc0d9/schema)