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

# Risk Assessment Flow

> How to create, review, and export a risk assessment

export const StorybookFrame = ({storyId, title, version = "20260419-1", height, zoom = 0.7, preferLocalPreview = false}) => {
  const HOSTED_STORYBOOK_BASE_URL = "https://minerva-storybook.s3.ca-central-1.amazonaws.com/iframe.html";
  const isLocalDocsPreview = typeof window !== "undefined" && ["localhost", "127.0.0.1"].includes(window.location.hostname);
  const storybookBaseUrl = preferLocalPreview && isLocalDocsPreview ? "http://localhost:6006/iframe.html" : HOSTED_STORYBOOK_BASE_URL;
  const params = new URLSearchParams({
    id: storyId,
    viewMode: "story",
    singleStory: "true",
    shortcuts: "false",
    toolbar: "0",
    nav: "0",
    panel: "0"
  });
  params.set("v", version);
  const src = `${storybookBaseUrl}?${params.toString()}`;
  const unscaledHeight = `${Math.ceil(height / zoom)}px`;
  const unscaledWidth = `${100 / zoom}%`;
  return <div style={{
    width: "100%"
  }}>
      <div style={{
    height: `${height}px`,
    overflow: "hidden",
    border: "1px solid #e2e8f0",
    borderRadius: "12px",
    backgroundColor: "#ffffff",
    display: "flex",
    justifyContent: "center",
    alignItems: "flex-start"
  }}>
        <iframe src={src} title={title} loading="lazy" style={{
    width: unscaledWidth,
    height: unscaledHeight,
    transform: `scale(${zoom})`,
    border: "0",
    display: "block",
    transformOrigin: "top center",
    flexShrink: 0
  }} allowFullScreen></iframe>
      </div>
    </div>;
};

The risk assessment workflow is designed for analysts who need to investigate an individual or organization beyond standard screening. Use it when you need a targeted search, ranked potential matches, and an exportable report.

## Before You Begin

* Confirm you have access to the **Risk Assessments** section
* Gather the subject name before starting
* Add date of birth, location, or other identifiers when available to improve match quality

## Step 1. Enter Subject Details

Choose whether you are assessing an **Individual** or an **Organization**, then complete the search form.

* **Full Name** is required
* **Birth Date** and **Location** improve result precision
* **Advanced Fields** can be used to narrow the search or validate known information

<StorybookFrame storyId="pages-risk-assessment-search-form--default" title="Risk Assessment Search Form" height={310} />

<Tip>
  Use the advanced fields only when you have reliable information to add.
  Precise data helps reduce weak or noisy matches.
</Tip>

## Step 2. Select Assessment Type and Sources

Choose the data categories you want to include in the assessment.

* In most cases, keep the default assessment type selected
* Preset assessment types help you start quickly
* **Custom** lets you manually control which lists and sources are included
* Source selection should reflect your investigation goal and internal policy

<StorybookFrame storyId="pages-risk-assessment-search-feed-selection--default" title="Risk Assessment Feed Selection" height={360} />

<Tip>
  Minerva's default assessment type is the recommended option for most searches.
  Change it only when you have a specific reason to narrow or expand the source
  set.
</Tip>

For more detail on Minerva source coverage, see [Data Feeds](/concepts/data-feeds).

## Step 3. Start the Assessment

Select **Start Assessment** to submit the search.

Minerva creates the request and returns a ranked list of potential matches based on the information you provided.

## Step 4. Review Potential Matches

Review the returned matches in order of **criteria match score**.

* Higher scores indicate a closer fit to the search criteria
* Review source context before making a decision
* Use supporting details to distinguish true matches from false positives

<StorybookFrame storyId="pages-risk-assessment-search-profiles-view--default" title="Risk Assessment Search Profiles View" height={480} />

### Understanding the Results Table

`Viewing results with match threshold ≥ 83.00%` means the table is currently showing only matches that meet or exceed the active minimum criteria match score. In this example, any result below `83%` is excluded from the list so you can focus on the closest matches first.

Use **Filters** to narrow the current result set without rerunning the search. This is useful when you want to focus on a smaller subset of matches based on the current review context.

Use **Risk Indicators** to review the types of risk signals associated with a returned match. These indicators help you understand why a profile may require closer review, such as sanctions, watchlist exposure, adverse media, politically exposed person status, or other flagged categories included in the selected sources.

Risk indicators are not a final decision on their own. Treat them as review cues that help you prioritize attention and decide whether to open the subject, compare supporting details, or escalate the result internally.

Use **No Record Match** when you have reviewed the returned matches and determined that none of them should be treated as a valid match for the subject. This creates a report that documents that conclusion for the current assessment.

Use **Combine and view** when multiple returned records appear to refer to the same subject and you want to review them together in a single combined result view.

## Step 5. Handle Empty Results

Some assessments return no potential matches at all. In that case, Minerva shows an empty-results state instead of the match table.

<StorybookFrame storyId="pages-risk-assessment-search-profiles-view--no-results" title="Risk Assessment Empty Results View" height={480} />

If no results are found, review which feeds were included in the search and confirm that the subject details were entered correctly.

Use **Generate Null Report** when you need a formal record that no relevant matches were found for the selected subject and source set.

## Step 6. View the Subject

Select a result row to open the subject view and review the full details for that specific match.

Use the subject view to inspect source context, supporting evidence, and the information that contributed to the criteria match score before deciding how to classify the result.

<StorybookFrame storyId="pages-risk-assessment-result-view-page--default" title="Risk Assessment Result View Page" height={480} />

Use this page to review the consolidated subject record, including identity details, source-specific evidence, linked entities, and any supporting media or notes that were assembled from the selected result.

## Step 7. Create a Report

Once your review is complete, generate a report if you need an audit-ready record or a file to share internally.

Reports can be exported as a PDF for documentation and compliance workflows.

## Expected Result

At the end of the flow, you should have:

* A completed assessment for the subject
* A ranked set of reviewed potential matches
* An exportable report when documentation is required

## Related Guides

* [Minerva App](/minerva-app)
* [Agent Risk Assessments Guide](/agent-risk-assessments-guide)
* [Data Feeds](/concepts/data-feeds)
* [API Introduction](/api-reference/introduction)