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

# List Forensic Events

Get a list of forensic events.

**Required scope:** `investigation-workbench:read`

## Parameters

<div className="integrations-table">
  | Parameter              | Description                                                                                                                            |
  | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
  | Company ID             | The Mitiga client company ID. Required when acting on behalf of another company.                                                       |
  | End Time               | The end time to filter results to.                                                                                                     |
  | Entity                 | The forensic entity ID to filter results by.                                                                                           |
  | Entity Comparison Type | The search operator for the `Entity` filter. Defaults to `EqualsCaseInsensitive`.                                                      |
  | Entity Type            | The type of entity to filter results by.                                                                                               |
  | Event Type             | A comma-separated list of forensic event types to filter results by.                                                                   |
  | IP Address             | A comma-separated list of `IPv4`, `IPv6`, or `hostnames` to filter forensic events by.                                                 |
  | Importance             | A comma-separated list of importance levels to filter forensic events by.                                                              |
  | Include Beta Events    | Select to include beta events in the results.                                                                                          |
  | Is Published           | Select to filter forensic events by whether they are published.                                                                        |
  | Platforms              | A comma-separated list of platforms to filter by.<br /><br />For example: `AWS`, `M365`, `AzureAD`, `GCP`, `Okta`, `Github`, and more. |
  | Start Time             | The start time to filter results from.                                                                                                 |
  | Status                 | A comma-separated list of forensic event statuses to filter results by.                                                                |
  | Suppression Status     | Select the suppression status to filter forensic events by. Defaults to `Retained` (non-suppressed) events only.                       |
  | Verdict                | A comma-separated list of verdicts to filter forensic events by.                                                                       |
</div>

## Workflow Library Example

[List Forensic Events with Mitiga and Send Results Via Email](https://library.blinkops.com/workflows/list-forensic-events-with-mitiga-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-forensic-events-with-mitiga-and-send-results-via-email/canvas" />
</div>