Skip to main content

​
Screening Results

Screening results appear in the screening section of the compliance report for both Company Verification and Person Verification flows, and as the primary response for standalone screening requests.

​
Screening Summary

The top-level screening object provides a quick status overview.
FieldTypeDescription
pep_statusstringNo Hit or Hit
sanctions_statusstringNo Hit or Hit
adverse_media_statusstringNo Hit or Hit
adverse_media_countintegerNumber of adverse media matches (0 if no hits)
screening_providerstringProvider name (e.g., WorldCheck)
screening_completed_atstring (datetime)ISO 8601 timestamp of screening completion

​
Example: Clean Result

{
  "screening": {
    "pep_status": "No Hit",
    "sanctions_status": "No Hit",
    "adverse_media_status": "No Hit",
    "screening_provider": "WorldCheck",
    "screening_completed_at": "2026-01-15T14:30:00Z"
  }
}

​
Example: Result with Hits

{
  "screening": {
    "pep_status": "Hit",
    "sanctions_status": "No Hit",
    "adverse_media_status": "Hit",
    "adverse_media_count": 2,
    "screening_provider": "WorldCheck",
    "screening_completed_at": "2026-01-15T14:30:00Z"
  }
}

​
Match Details

When hits are found, the matches[] array contains detailed information about each match.
FieldTypeDescription
matchScorenumberMatch confidence score, 0-100
primaryNamestringPrimary name of the matched entity in the database
categorystringPrimary match category: pep, sanctions, adverse_media, watchlist
categories[]array of stringAll categories for this match (e.g., pep-class-2, adverse-media-financial-crime)
types[]array of stringSpecific sub-types (e.g., sanction-sdn, pep-class-2)
nationalitystringNationality of the matched entity
dateOfBirthstringDate of birth of the matched entity
sources[]array of stringData sources (e.g., OFAC SDN, UK HMT, UK Parliament)
media[]array of objectAssociated news articles (adverse media matches)
associates[]array of objectKnown associates (PEP matches)
positions[]array of objectPolitical positions held (PEP matches)

​
Media Object

FieldTypeDescription
media[].titlestringArticle headline
media[].urlstringArticle URL
media[].snippetstringBrief excerpt from the article
media[].datestringPublication date

​
Associate Object

FieldTypeDescription
associates[].namestringAssociate’s full name
associates[].associationstringRelationship description (e.g., Spouse, Business Partner)
associates[].typestringAssociation category: family or business

​
Position Object

FieldTypeDescription
positions[].titlestringPosition title (e.g., Member of Parliament)
positions[].countrystringCountry of the position
positions[].fromstringStart date
positions[].tostringEnd date (empty if current)

​
Full Match Example

{
  "matches": [
    {
      "matchScore": 95.0,
      "primaryName": "John Andrew Smith",
      "category": "pep",
      "categories": ["pep-class-2"],
      "types": ["pep-class-2"],
      "nationality": "British",
      "dateOfBirth": "1975-03-20",
      "sources": ["UK Parliament"],
      "positions": [
        {
          "title": "Member of Parliament",
          "country": "United Kingdom",
          "from": "2019-12-12",
          "to": "2024-07-04"
        }
      ],
      "associates": [
        {
          "name": "Mary Smith",
          "association": "Spouse",
          "type": "family"
        }
      ]
    },
    {
      "matchScore": 78.5,
      "primaryName": "John Smith",
      "category": "adverse_media",
      "categories": ["adverse-media-financial-crime"],
      "types": ["adverse-media"],
      "nationality": "British",
      "media": [
        {
          "title": "Investigation into financial irregularities at Acme Holdings",
          "url": "https://example.com/article-123",
          "snippet": "Authorities are investigating potential financial irregularities...",
          "date": "2025-06-15"
        }
      ]
    }
  ]
}

​
Match Score Interpretation

Score RangeConfidenceRecommended Action
90-100Very HighStrong match. Investigate immediately
80-89HighLikely match. Manual review required
70-79MediumPossible match. Review recommended
Below 70LowWeak match. Likely a false positive
Scores above 90 combined with matching date of birth and nationality are near-certain matches. Scores in the 70-79 range should still be reviewed, especially when combined with other risk factors like high-risk jurisdictions or complex ownership structures.

​
PEP Classifications

WorldCheck classifies Politically Exposed Persons into four tiers:
ClassDescriptionExamples
pep-class-1Heads of state and senior national governmentPresidents, prime ministers, cabinet members
pep-class-2Regional and local government officialsMembers of parliament, mayors, governors
pep-class-3Other senior public officialsSenior military officers, judiciary, central bank governors
pep-class-4Associates and family membersSpouses, children, known business partners of PEP classes 1-3
PEP Class 1 matches require senior compliance review regardless of match score. Classes 2-3 require standard enhanced due diligence. Class 4 matches indicate close association with a PEP and should be flagged for review.

​
Sanctions List Types

TypeSourceJurisdiction
sanction-sdnOFAC Specially Designated NationalsUnited States
sanction-euEU Consolidated Sanctions ListEuropean Union
sanction-unUN Security Council Consolidated ListInternational
sanction-hmtHM Treasury Consolidated ListUnited Kingdom
Any sanctions match, regardless of score or list, requires immediate action. Do not proceed with onboarding or transaction processing for sanctioned entities.

​
Screening Decision Matrix

CategoryScoreRecommended Action
Sanctions HitAnyImmediate escalation. Do not proceed
PEP Class 1-2Above 80Enhanced due diligence required
PEP Class 3-4Above 80Standard review with ongoing monitoring
Adverse MediaAbove 85Manual review required
Adverse Media70-85Review if combined with other risk factors
WatchlistAnyImmediate escalation