Become a Box Certified: AI Professional — and score an exclusive t-shirt reserved for the first 100 people who pass. Click here

Box Status
Print

Legal Holds Report

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. 

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:  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. 

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 of the admin who ran the report or who set up the report schedule.

Legal Holds report data columns

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

Assignment Type

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

  • user - Access
  • user - Interactions
  • user - Ownership
  • folder
  • file
  • file version
Assignment ID
A number the uniquely identifies the legal hold assignment.
Parent Folder Path
The path from the root of your Box instance to the folder containing the file.
Parent Folder Path ID
A number that uniquely identifies the path from the root of your Box instance to the folder containing the file.
File Name
The name given to the file.
File ID
A number that uniquely identifies the file version put on hold.
File Version ID
A number that uniquely identifies the newest version of the file.
Created
The date, in UTC, that the file was created.
Uploaded
The date, in UTC, that the latest version of the file was uploaded.
Size (bytes)
The size of the file in bytes.
Owner ID
The value in the Name field in User Account Details of the owner of the file.
Reason For Hold

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

  • Owner
  • Collaborator
  • Folder
  • File
  • File Version
Trashed

Indicates if the file is in Trash when the report is run. Values can be:

  • Yes
  • No
Custodian Email

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

Owner Email

The email address of the file's owner.

Related articles