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

# Adverse Media Categories

> How to choose financial and non-financial adverse media risk categories by workspace and screening channel, including per-search API overrides.

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>;
};

Adverse media categories describe the type of risk Minerva found in an article. Administrators can choose which categories Minerva is allowed to emit for each screening channel, while API integrations can override that choice for one synchronous search or one entity in a batch.

**Access:** Requires the <strong>Admin</strong> role or above. In the sidebar, go to <strong>Administration</strong> > <strong>Configuration</strong> > <strong>Adverse Media</strong>, then open <strong>Adverse Media Risk Classification</strong>.

Use this guide when you need to:

* align adverse media output with your AML, KYC, background-check, or general screening policy
* add or remove categories independently across Minerva's four screening channels
* understand the distinction between financial and non-financial crime risk categories
* preserve a known API response contract while testing newly introduced categories
* override the category set for one synchronous search or one entity in a batch

<Info>
  Category configuration is workspace-scoped. A Calibration workspace can use a
  different category set from Live, and changing one workspace does not change
  another.
</Info>

<Warning>
  A risk category is a machine-learning classification of article content, not a
  finding of guilt, a legal conclusion, or proof that the article concerns the
  screened subject. Review the identity evidence, source, article context,
  jurisdiction, dates, and case disposition before making a decision.
</Warning>

## How Category Classification Works

Minerva evaluates qualifying adverse media articles for sentiment and one or more supported risk topics. An article can receive more than one risk category when its content supports multiple themes. For example, reporting about a bribery scheme that launders proceeds through real estate can support <strong>Fraud/Bribery/Corruption</strong>, <strong>Money Laundering</strong>, and <strong>Real Estate</strong>.

The category configuration is an allow-list:

* an <strong>enabled</strong> category may appear when the model finds enough evidence for it
* a <strong>disabled</strong> category cannot appear in adverse media risk scores or article flags and cannot contribute to screening outcomes
* enabling a category does not force Minerva to assign it
* disabling a category does not stop article retrieval or disable the News feed
* category changes affect subsequent searches and article processing; they do not rewrite completed search results

The model's internal no-risk outcome is not a configurable category.

## Financial And Non-Financial Risk

The two groups help administrators align the category set with the purpose of a screening program. They are configuration groupings, not legal classifications.

### Financial Crime Risks

The <strong>Financial Crime Risks</strong> group contains 28 AML-relevant themes. Its scope is intentionally broader than money laundering alone and includes:

* money laundering, movement of value, concealment of ownership, and sanctions evasion
* alleged predicate offences that may generate criminal proceeds, such as fraud, bribery, corruption, narcotics trafficking, human trafficking, smuggling, tax evasion, and organized crime
* terrorist activity and terrorist financing
* products, services, sectors, and assets that can be abused to move or disguise value, such as cryptocurrency, money service businesses, foreign exchange, real estate, casinos, art, precious materials, auctions, and luxury vehicles

These labels help surface media that may be relevant to customer due diligence, enhanced due diligence, transaction-monitoring context, or suspicious activity review. Whether a theme is in scope for a particular AML program depends on the organization's jurisdiction, products, customer base, risk assessment, and procedures.

<Note>
  A sector-oriented category does not mean that ordinary activity in that sector
  is adverse. Minerva assigns risk categories from the article's adverse
  context—for example, laundering through an auction house—not merely because
  the article mentions an auction.
</Note>

### Non-Financial Crime Risks

The <strong>Non-Financial Crime Risks</strong> group covers adverse conduct that is useful for background checks, safety reviews, or broader criminal-risk screening but is not, by itself, a financial-crime theme:

* <strong>Other (Non-Financial)</strong> is the legacy catch-all for serious
  adverse conduct that does not fit a specific financial category
* <strong>DUI</strong> covers impaired-driving offences
* <strong>Property Damage</strong> covers vandalism and other attributed damage
  to property
* <strong>Assault and Battery</strong> covers physical violence against another
  person

An article may still receive both financial and non-financial categories when the facts support both. For example, an alleged assault connected to an organized-crime enterprise can support <strong>Assault and Battery</strong> and <strong>Organized Crime</strong>.

## Default Category Set

New and previously unconfigured workspaces preserve Minerva's established 29-category response contract:

* all 28 financial crime categories are enabled
* <strong>Other (Non-Financial)</strong> is enabled
* <strong>DUI</strong>, <strong>Property Damage</strong>, and
  <strong>Assault and Battery</strong> are disabled until an administrator
  enables them

This default prevents newly introduced risk-score keys from appearing unexpectedly in customer integrations. Enable a new category only after downstream mappings, reports, rules, and API consumers are ready to accept it.

## Financial Crime Category Reference

| Display name                                | API key                    | What the category covers                                                                                |
| ------------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------- |
| <strong>Auctions</strong>                   | `auctions`                 | Auction-related financial crime, including bid rigging, auction fraud, or value laundering.             |
| <strong>Casinos</strong>                    | `casinos`                  | Gambling-sector crime, illegal operations, junket risk, or laundering through casinos.                  |
| <strong>Cryptocurrency</strong>             | `cryptocurrency`           | Virtual-asset fraud, illicit payments, darknet activity, mixers, or unregistered exchanges.             |
| <strong>Currency Exchanges / Forex</strong> | `international_services`   | Unlicensed foreign-exchange activity, black-market currency trading, or exchange-based laundering.      |
| <strong>Cybercrime</strong>                 | `cybercrime`               | Hacking, ransomware, phishing, account takeover, data theft, or other technology-enabled crime.         |
| <strong>Fine Art</strong>                   | `fine_art`                 | Art fraud or forgery, cultural-property smuggling, or laundering value through art.                     |
| <strong>Foreign Assets</strong>             | `foreign_ownership`        | Hidden offshore accounts, shell structures, unexplained overseas wealth, or high-risk foreign holdings. |
| <strong>Fraud/Bribery/Corruption</strong>   | `fraud_bribery_corruption` | Fraud, bribery, corruption, embezzlement, kickbacks, or abuse of position for gain.                     |
| <strong>Human Trafficking</strong>          | `human_trafficking`        | Forced labour, sex trafficking, or other exploitation and trafficking of people.                        |
| <strong>Insider Trading</strong>            | `insider_trading`          | Trading or tipping on material non-public information, front-running, or insider-led manipulation.      |
| <strong>Lending Services</strong>           | `loan_companies`           | Loan-sharking, predatory or unlicensed lending, and lending-related fraud.                              |
| <strong>Luxury Vehicles</strong>            | `luxury_vehicles`          | Laundering through high-value vehicles, stolen-vehicle networks, or related tax fraud.                  |
| <strong>Money Laundering</strong>           | `moneylaundering`          | Concealing, layering, integrating, or moving suspected illicit proceeds.                                |
| <strong>Money Service Businesses</strong>   | `third_party_transactions` | Unlicensed remittance, suspicious money transfer, structuring through MSBs, or informal value transfer. |
| <strong>Narcotics</strong>                  | `narcotics`                | Illegal production, trafficking, smuggling, or distribution of controlled substances.                   |
| <strong>Non-profit</strong>                 | `non_profit`               | Diversion of donations, sham charities, or misuse of non-profit entities to move funds.                 |
| <strong>Organized Crime</strong>            | `organized_crime`          | Mafia, cartel, gang, racketeering, or other criminal-enterprise involvement.                            |
| <strong>Rare Gems and Metals</strong>       | `rare_gems_metals`         | Conflict minerals, gold or gem smuggling, or laundering through precious materials.                     |
| <strong>Real Estate</strong>                | `real_estate`              | Property-related laundering, mortgage fraud, straw buyers, or other real-estate crime.                  |
| <strong>Recreational Drugs</strong>         | `recreational_drugs`       | Adverse conduct involving recreational drugs, possession offences, or unlicensed operations.            |
| <strong>Sanctions</strong>                  | `sanctions`                | Sanctions evasion, embargo breaches, or trading with designated parties.                                |
| <strong>Sex Industry</strong>               | `sex_industry`             | Illegal, exploitative, or financial-crime activity connected with the commercial sex industry.          |
| <strong>Smuggling/Contraband</strong>       | `smuggling`                | Illegal cross-border movement of goods, evasion of customs, or contraband trade.                        |
| <strong>Tax Evasion</strong>                | `tax_evasion`              | Concealing taxable income, false returns, offshore evasion, or VAT/carousel fraud.                      |
| <strong>Terror Funding</strong>             | `terror_funding`           | Raising, moving, or providing funds for terrorist activity or organizations.                            |
| <strong>Terrorism</strong>                  | `terrorism`                | Terrorist acts, membership, planning, recruitment, or incitement.                                       |
| <strong>Used Merchandise</strong>           | `used_merchandise`         | Fencing stolen goods, pawnshop laundering, or counterfeit second-hand trade.                            |
| <strong>Weapon Sales/Trade</strong>         | `weapons`                  | Illegal firearms sales, arms trafficking, embargo violations, or illicit weapons brokering.             |

## Non-Financial Category Reference

| Display name                           | API key           | Default  | What the category covers                                                                         |
| -------------------------------------- | ----------------- | -------- | ------------------------------------------------------------------------------------------------ |
| <strong>Other (Non-Financial)</strong> | `other`           | Enabled  | Serious adverse conduct that does not fit one of the specific financial categories.              |
| <strong>Assault and Battery</strong>   | `assault_battery` | Disabled | Alleged or reported physical violence, including assault, battery, fights, or domestic violence. |
| <strong>DUI</strong>                   | `dui`             | Disabled | DUI/DWI, impaired-driving arrests or charges, and related intoxicated-driving incidents.         |
| <strong>Property Damage</strong>       | `property_damage` | Disabled | Vandalism, arson-adjacent incidents, collisions, or other attributed property damage.            |

## Configure Categories Across Screening Channels

The configuration page separates four channels:

| Channel                             | What it covers                                                                                  |
| ----------------------------------- | ----------------------------------------------------------------------------------------------- |
| <strong>Onboarding</strong>         | Screening performed while a new customer or profile is being onboarded.                         |
| <strong>Ongoing Monitoring</strong> | Recurring screening for existing profiles.                                                      |
| <strong>Direct API Calls</strong>   | Synchronous and batch searches submitted with an API application associated with the workspace. |
| <strong>Risk Assessments</strong>   | Searches run inside risk-assessment and due-diligence workflows.                                |

<StorybookFrame storyId="pages-tenant-config-adverse-media-risk-classification--default" title="Adverse Media Risk Classification Configuration" height={800} version="20260726-1" preferLocalPreview />

To change a workspace:

1. Select the intended workspace, such as <strong>Calibration</strong> or <strong>Live</strong>.
2. Open the channel tab you want to change.
3. Check a category to allow it, or clear it to prevent it from being emitted.
4. Use <strong>Select all categories</strong> only when every downstream consumer can accept all supported keys.
5. Use <strong>Restore defaults</strong> to return that channel to the standard 29-category set.
6. Repeat the review for each channel that needs a different category set.
7. Select <strong>Review changes</strong>, confirm the affected channels and categories, add a clear change description, and save.

Use <strong>History</strong> to review prior deployments or restore an earlier configuration. A rollback creates a new history entry and preserves the audit trail.

<Tip>
  Start with one channel in a Calibration workspace. Compare true-positive
  retention, false-positive volume, reports, rules, and downstream API mappings
  before reproducing the approved configuration in Live.
</Tip>

## Override Categories For One API Search

The <strong>Direct API Calls</strong> channel supplies the workspace default for API searches. An integration can replace that default for one call by sending the raw category keys in:

```text theme={null}
global_filters.adverse_media_risk_categories
```

Resolution order is:

1. request-level `global_filters.adverse_media_risk_categories`
2. the selected workspace's <strong>Direct API Calls</strong> configuration
3. the standard 29-category default when no workspace configuration exists

A request override can narrow or widen the workspace set. It can therefore enable a category that the workspace leaves disabled. An empty array disables every adverse media risk category for that call. Unknown keys are rejected with an HTTP `400` response that identifies the invalid values.

The override changes category emission only. It does not add the News feed or broaden article retrieval, so include `News` in `feeds` when the search should perform adverse media analysis.

### Synchronous Search

Place the override in the `POST /v1/search-sync` request body:

```json theme={null}
{
  "type": "individual",
  "name": "John Smith",
  "feeds": ["News"],
  "global_filters": {
    "adverse_media_risk_categories": [
      "moneylaundering",
      "fraud_bribery_corruption",
      "sanctions"
    ]
  }
}
```

See [Search Sync: adverse media risk categories configuration](https://docs.gominerva.com/api-reference/search/single-search-synchronous-api#adverse-media-risk-categories-configuration) for the live request schema.

### Batch Search

Place the override inside each applicable object in `requests[]`. Each entity can use a different category set:

```json theme={null}
{
  "requests": [
    {
      "type": "Individual",
      "name": "John Smith",
      "global_filters": {
        "adverse_media_risk_categories": [
          "moneylaundering",
          "fraud_bribery_corruption",
          "sanctions"
        ]
      }
    },
    {
      "type": "Organization",
      "name": "Example Holdings",
      "global_filters": {
        "adverse_media_risk_categories": []
      }
    }
  ],
  "feeds": ["News"]
}
```

See [Batch Search: adverse media risk categories configuration](https://docs.gominerva.com/api-reference/search/batch-asynchronous-search-api#adverse-media-risk-categories-configuration) for the live request schema.

## Related Guides

* [Adverse Media](/concepts/adverse-media)
* [Screening Guide](/screening-guide)
* [Match Scoring Guide](/match-scoring-guide)
* [Role-Aware Adverse Media Guide](/role-aware-adverse-media-guide)
* [Workspaces Guide](/workspaces-guide)