Skip to main content
The adverse media screening check response payload contains a detailed analysis of any negative news or adverse media mentions related to the business. The check evaluates news articles, media coverage, and other public sources for potential risks or concerns.

​
Check ID

kyb.adverse_media_screening_check_v2

​
Response Structure

{
  type: "KYBAdverseMediaScreeningCheckResultV2";
  verified_adverse_media_hits: Array<BusinessAdverseMediaProfile>;
}

type BusinessAdverseMediaProfile = {
  profile_review: {
    match_rating: {
      match: "STRONG_MATCH" | "PARTIAL_MATCH" | "WEAK_MATCH" | "NO_MATCH" | "UNKNOWN";
      score: number;
    };
    business_name_match: boolean;
    location_match: boolean;
    summarize: () => string;
  };
  business_name: string | null;
  location: string | null;
  adverse_events: Array<{
    event_type: string;
    description: string;
    source_url: string | null;
    source_name: string | null;
    publication_date: string | null;
  }>;
  escalate_for_review: boolean;
}

​
Example Response

{
  "type": "KYBAdverseMediaScreeningCheckResultV2",
  "verified_adverse_media_hits": [
    {
      "profile_review": {
        "match_rating": {
          "match": "STRONG_MATCH",
          "score": 95
        },
        "business_name_match": true,
        "location_match": true
      },
      "business_name": "Company XYZ Inc",
      "location": "Delaware, US",
      "adverse_events": [
        {
          "event_type": "Regulatory Investigation",
          "description": "Company XYZ is under investigation for potential compliance violations regarding financial reporting practices",
          "source_url": "https://example.com/article1",
          "source_name": "Business News Daily",
          "publication_date": "2024-01-15"
        },
        {
          "event_type": "Civil Litigation",
          "description": "Class action lawsuit filed against Company XYZ alleging securities fraud",
          "source_url": "https://example.com/article2",
          "source_name": "Legal News",
          "publication_date": "2024-02-01"
        }
      ],
      "escalate_for_review": true
    }
  ]
}

​
Response Fields

​
type
string
The type identifier for the response. Will be “KYBAdverseMediaScreeningCheckResultV2”.
​
verified_adverse_media_hits
array
List of verified adverse media profiles for the business.
​
profile_review
object
Match analysis and rating for this adverse media profile.
​
match_rating
object
The confidence level of the match.
​
match
string
Match strength: STRONG_MATCH, PARTIAL_MATCH, WEAK_MATCH, NO_MATCH, or UNKNOWN.
​
score
number
Numerical match confidence score (0-100).
​
business_name_match
boolean
Whether the business name matches the profile.
​
location_match
boolean
Whether the location matches the profile.
​
business_name
string | null
Name of the business in the adverse media profile.
​
location
string | null
Location associated with the adverse media profile.
​
adverse_events
array
List of adverse events associated with this profile.
​
event_type
string
Category of the adverse event (e.g., “Regulatory Investigation”, “Civil Litigation”).
​
description
string
Detailed description of the adverse event.
​
source_url
string | null
URL of the source article or document.
​
source_name
string | null
Name of the publication or source.
​
publication_date
string | null
Date when the article was published (YYYY-MM-DD).
​
escalate_for_review
boolean
Whether this profile should be escalated for manual review based on match ratings and risk thresholds.

​
Key Components

​
Match Rating System

The V2 check uses a sophisticated match rating system to determine confidence in adverse media matches:
  1. STRONG_MATCH: High confidence that the adverse media refers to the screened business
    • Business name matches closely
    • Location matches
    • Other identifying details align
  2. PARTIAL_MATCH: Moderate confidence in the match
    • Business name is similar but not exact
    • Some geographic or contextual alignment
    • May require manual review
  3. WEAK_MATCH: Low confidence in the match
    • Name similarity is limited
    • Location may not match
    • Likely a different business with a similar name
  4. NO_MATCH: Clear mismatch
    • Business name is significantly different
    • Location doesn’t match
    • Context clearly indicates a different entity
  5. UNKNOWN: Unable to determine match confidence
    • Insufficient information
    • Ambiguous details

​
Adverse Event Analysis

The check categorizes adverse media findings by event type:
  • Regulatory Investigation: Government or regulatory body inquiries
  • Civil Litigation: Lawsuits and legal disputes
  • Criminal Activity: Criminal charges or investigations
  • Financial Issues: Bankruptcy, fraud, or financial misconduct
  • Operational Problems: Business failures or operational issues
  • Reputational Concerns: Negative publicity or scandal

​
Verification Process

The check performs the following verifications:
  1. Data Collection: Searches news archives and media databases
  2. Profile Extraction: Identifies adverse media profiles related to businesses
  3. Match Analysis: Evaluates business name and location matches
  4. Event Categorization: Classifies adverse events by type and severity
  5. Confidence Scoring: Assigns match ratings based on multiple factors
  6. Review Flagging: Marks profiles for manual review based on configurable thresholds

​
Escalation Criteria

Profiles are flagged for manual review (escalate_for_review: true) based on:
  1. Match Rating Thresholds:
    • Strong matches are typically escalated
    • Partial matches may be escalated based on configuration
    • Weak matches and no matches are usually not escalated
  2. Event Severity:
    • Regulatory investigations
    • Criminal activity
    • Major financial fraud
    • Ongoing litigation
  3. Configurable Rules:
    • deny_match_ratings: Match ratings that automatically fail the check
    • review_match_ratings: Match ratings that require manual review
    • business_name_matching_threshold: Required name match precision
    • location_matching_threshold: Required location match precision