---
title: "List legal hold policy assignments"
method: GET
path: "/legal_hold_policy_assignments"
tags: ["Legal hold policy assignments"]
---

# List legal hold policy assignments

`GET /legal_hold_policy_assignments`

Retrieves a list of items a legal hold policy has been assigned to.

## Query parameters

- `policy_id` string, required
- `assign_to_type` 'file' | 'file_version' | 'folder' | 'user' | 'ownership' | 'interactions'
- `assign_to_id` string
- `marker` string
- `limit` integer
- `fields` string[]

## Response `200`

Returns a list of legal hold policy assignments.

- LegalHoldPolicyAssignments — The part of an API response that describes marker based pagination.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `next_marker` string, nullable — The marker for the start of the next page of results.
  - `prev_marker` string, nullable — The marker for the start of the previous page of results.
  - `entries` LegalHoldPolicyAssignment[] — A list of legal hold policy assignments.
    - `id` string — The unique identifier for this legal hold assignment.
    - `type` 'legal_hold_policy_assignment' — The value will always be `legal_hold_policy_assignment`.
    - `legal_hold_policy` object — The policy that the legal hold policy assignment is part of.
      - `id` string, required — The unique identifier for this legal hold policy.
      - `type` 'legal_hold_policy', required — The value will always be `legal_hold_policy`.
    - `assigned_to` object — The item that the legal hold policy is assigned to. Includes type and ID.
      - `type` 'file' | 'file_version' | 'folder' | 'user' | 'ownership' | 'interactions', required — The type of item the policy is assigned to.
      - `id` string, required — The ID of the item the policy is assigned to.
    - `assigned_by` object — The user who created the legal hold policy assignment.
      - `id` string, required — The unique identifier for this user.
      - `type` 'user', required — The value will always be `user`.
      - `name` string — The display name of this user.
      - `login` string, email — The primary email address of this user.
    - `assigned_at` string, date-time — When the legal hold policy assignment object was created.
    - `deleted_at` string, date-time — When the assignment release request was sent. (Because it can take time for an assignment to fully delete, this isn't quite the same time that the assignment is fully deleted). If null, Assignment was not deleted.

## Other responses

- `default` — An unexpected client error.

---

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