> ## Documentation Index
> Fetch the complete documentation index at: https://docs.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Legal Holds Report

<div className="article_labels_list" style={{display: 'none'}} dangerouslySetInnerHTML={{__html: "Overview , Reporting , Admin , Article , Account Administration , Established"}} />

A Legal Hold report exports a list of all the files currently being held by an active [legal hold](/en/box-governance/legal-holds/about-legal-hold-policies).

To run a Legal Hold report:

1. Navigate to the **Admin Console**, then **Governance**.
2. Select the **Legal Holds** tab.
3. Hover over the relevant Legal Hold then click the **Report** button.

You can also, from the **Admin Console**, click into **Reports** > **Create Report** > **Legal Hold Content**, then hover over the relevant Legal Hold and click **Report**.

<Note>
  **Note**

  Legal hold policy reports contain data up to 48 hours prior to the report being generated. Updates to the report are processed asynchronously. There may, therefore, be temporary discrepancies in the report. If this occurs, wait a short time then run the report again.
</Note>

## Legal Holds report details

* **File format**: comma-separated value (.csv) file
* **Filename format**:`legal_holds_[case name]_run_on_YYYY-MM-DD__HH-MM-SS-[A|P]M_Page_#.csv`
* **Folder name format** (each report run is placed in its own folder):`Legal Holds run on YYYY-MM-DD HH-MM-SS`
* **Filename and folder name time zone**: the local [date and time](/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data) of the admin who ran the report or who set up the report [schedule](/en/box-admin-tools/reporting-and-insights/scheduling-reports).

### Legal Holds report data columns

This section describes the data columns that are generated in Legal Holds reports.

<h4 id="assignment-type">
  Assignment Type
</h4>

Explains what type of assignment placed a file version on hold. Values can be:

* user - Access
* user - Interactions
* user - Ownership
* folder
* file
* file version

<h4 id="assignment-id">
  Assignment ID
</h4>

A number the uniquely identifies the legal hold assignment.

<h4 id="parent-folder-path">
  Parent Folder Path
</h4>

The path from the root of your Box instance to the folder containing the file.

<h4 id="parent-folder-path-id">
  Parent Folder Path ID
</h4>

A number that uniquely identifies the path from the root of your Box instance to the folder containing the file.

<h4 id="file-name">
  File Name
</h4>

The name given to the file.

<h4 id="file-id">
  File ID
</h4>

A number that uniquely identifies the file version put on hold.

<h4 id="file-version-id">
  File Version ID
</h4>

A number that uniquely identifies the newest version of the file.

<h4 id="created">
  Created
</h4>

The [date](/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data), in UTC, that the file was created.

<h4 id="uploaded">
  Uploaded
</h4>

The [date](/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data), in UTC, that the latest version of the file was uploaded.

<h4 id="size-bytes">
  Size (bytes)
</h4>

The size of the file in bytes.

<h4 id="owner-id">
  Owner ID
</h4>

The value in the *Name* field in User Account Details of the owner of the file.

<h4 id="reason-for-hold">
  Reason For Hold
</h4>

Explanation why a file version was put on hold. Values can be:

* Owner
* Collaborator
* Folder
* File
* File Version

<h4 id="trashed">
  Trashed
</h4>

Indicates if the file is in [Trash](/en/box-fundamentals/for-users/staying-organized/managing-files-and-folders/managing-trash) when the report is run. Values can be:

* Yes
* No

<h4 id="custodian-email">
  Custodian Email
</h4>

The email address of the custodian (managed-user).

<h4 id="owner-email">
  Owner Email
</h4>

The email address of the file's owner.
