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

# Retention Report

[Retention policies](https://docs.box.com/en/box-governance/retention/about-retention-and-retention-policies.md) enable you to retain certain types of content in Box for a specified period of time, and remove content from Box that is no longer relevant. A retention report exports details of a particular retention policy, along with a list of all of the files the policy covers. Retention reports do not include files that have already met their retention requirements and been removed.

> [!NOTE]
>
> Retention policy reports contain data up to 48 hours prior to the report being generated.

## Retention Report details

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

### Retention report information

Retention reports include details of a particular retention policy, along with a list of all of the files the policy covers.

Retention reports include the following information about the retention policy, in addition to the report's data columns:

<table border="1">
  <thead>
    <tr>
      <th>Retention Policy Information</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Policy Name</td>
      <td>The name of the retention policy.</td>
    </tr>

    <tr>
      <td>Policy Status</td>

      <td>
        The status of the retention policy. Values can be:

        <ul>
          <li>active: The policy is active and retaining the designated files per the policy's configuration.</li>
          <li>retired: The retention policy is not retaining files.</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Assignment Type</td>

      <td>
        The content that the policy is applied to, taken from the Apply Policy To setting value. Values can be:

        <ul>
          <li>Folder(s): When *Content within specific folders* is selected as the policy setting.</li>
          <li>Metadata: When *Content with specific metadata* is selected as the policy setting.</li>
          <li>All: When *All new content* is selected as the policy setting.</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Retention Type</td>

      <td>
        The [type of retention policy](https://docs.box.com/en/box-governance/retention/about-retention-and-retention-policies.md#modifiable-and-non-modifiable-retention). Values can be:

        <ul>
          <li>Modifiable</li>
          <li>Non-modifiable</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Policy Time Period</td>

      <td>
        The amount of time content is retained by policy, taken from the Time Period Duration policy setting. The value is the number of days.
      </td>
    </tr>

    <tr>
      <td>Policy Disposition Action</td>

      <td>
        The action taken on files once the policy time period ends, taken from the Disposition Action setting value. Values can be:

        <ul>
          <li>remove\_retention: When *None* is selected as the policy setting, which means retention will be released on files governed by the policy.</li>
          <li>permanently\_delete: When *Permanently delete content* is selected as the policy setting, which means files governed by the policy will be irretrievably deleted.</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Policy Created Date</td>
      <td>The [date](https://docs.box.com/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data.md), in UTC, that the retention policy was created.</td>
    </tr>
  </tbody>
</table>

### Retention report data columns

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

<table border="1">
  <thead>
    <tr>
      <th>Data Column</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Parent Folder Path</td>
      <td>The path from the root of your Box instance to the folder that contains the file.</td>
    </tr>

    <tr>
      <td>Parent Folder Path IDs</td>
      <td>A number that uniquely identifies the parent folder.</td>
    </tr>

    <tr>
      <td>File Name</td>
      <td>The name given to the file.</td>
    </tr>

    <tr>
      <td>File ID</td>
      <td>A number that uniquely identifies the file.</td>
    </tr>

    <tr>
      <td>File Version ID</td>
      <td>A number that uniquely identifies the version of the file.</td>
    </tr>

    <tr>
      <td>Created</td>
      <td>The [date](https://docs.box.com/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data.md), in UTC, that the file was created.</td>
    </tr>

    <tr>
      <td>Uploaded</td>
      <td>The [date](https://docs.box.com/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data.md), in UTC, that the version of the file was uploaded.</td>
    </tr>

    <tr>
      <td>Disposition Date</td>
      <td>The [date](https://docs.box.com/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data.md), in UTC, on which the policy disposition action will take place for the file.</td>
    </tr>

    <tr>
      <td>Trashed</td>

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

        <ul>
          <li>Yes</li>
          <li>No</li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>