---
schema_version: "1"
id: 7a37c90928f22dab55b5807a5b28c8d986144300e1b5b53b59eddf2595d559d7
title: Security | Retrieve Investigations
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_ref_retrieve_investigations.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_ref_retrieve_investigations.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 6664043b500293a5aed59fdcbd9bfebc7fcb9de3e2f449513f7b1cdceef1a26c
description: Returns a list of security investigations, with optional filters for stage, category, or date range. The information can include associated findings, timeline entries, and remediation plans.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Security | Retrieve Investigations

Returns a list of security investigations, with optional filters for stage, category, or date range. The information can include associated findings, timeline entries, and remediation plans.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions with the Security Center add-on and Foundations or <strong>Agentforce 1</strong> Editions.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d54338e75">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d54338e75 ">To view Security Center pages:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d54338e75 ">View Security Center</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d54338e75 ">To create and edit security policies:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d54338e75 ">Manage Security Center</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d54338e75 ">See <a href="https://help.salesforce.com/s/articleView?id=ai.agent_actions_common_perms.htm&amp;type=5&amp;language=en_US" target="_blank">Common User Access for Standard Agent
                Actions</a>.</td>

          </tr>
        </tbody>
      </table>

## Action Details

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col style="width:50%"> <col style="width:50%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">API Name</td><td class="slds-cell-wrap" style="vertical-align:top;">RetrieveInvestigations</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Reference Action Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Standard Action</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Does this tool run one or more prompt templates?</td><td class="slds-cell-wrap" style="vertical-align:top;">No</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Required setup</td><td class="slds-cell-wrap" style="vertical-align:top;">Turn on Security Center and Security Agent with View Security Center or Manage Security Center user permission.</td></tr></tbody></table>

## Guidelines and Considerations

Use `RetrieveInvestigations` to discover existing investigations before retrieving specific investigation details.

- Supports filtering by investigation stage, category, and date range.
- Includes associated findings, timeline entries, and remediation plans as optional data.
- Returns a mapping of investigation IDs to names for easy lookup.
- Discovers existing investigations before retrieving specific investigation details.