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.

Field	Type	Description
`pep_status`	string	`No Hit` or `Hit`
`sanctions_status`	string	`No Hit` or `Hit`
`adverse_media_status`	string	`No Hit` or `Hit`
`adverse_media_count`	integer	Number of adverse media matches (0 if no hits)
`screening_provider`	string	Provider name (e.g., `WorldCheck`)
`screening_completed_at`	string (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.

Field	Type	Description
`matchScore`	number	Match confidence score, 0-100
`primaryName`	string	Primary name of the matched entity in the database
`category`	string	Primary match category: `pep`, `sanctions`, `adverse_media`, `watchlist`
`categories[]`	array of string	All categories for this match (e.g., `pep-class-2`, `adverse-media-financial-crime`)
`types[]`	array of string	Specific sub-types (e.g., `sanction-sdn`, `pep-class-2`)
`nationality`	string	Nationality of the matched entity
`dateOfBirth`	string	Date of birth of the matched entity
`sources[]`	array of string	Data sources (e.g., `OFAC SDN`, `UK HMT`, `UK Parliament`)
`media[]`	array of object	Associated news articles (adverse media matches)
`associates[]`	array of object	Known associates (PEP matches)
`positions[]`	array of object	Political positions held (PEP matches)

Media Object

Field	Type	Description
`media[].title`	string	Article headline
`media[].url`	string	Article URL
`media[].snippet`	string	Brief excerpt from the article
`media[].date`	string	Publication date

Associate Object

Field	Type	Description
`associates[].name`	string	Associate’s full name
`associates[].association`	string	Relationship description (e.g., `Spouse`, `Business Partner`)
`associates[].type`	string	Association category: `family` or `business`

Position Object

Field	Type	Description
`positions[].title`	string	Position title (e.g., `Member of Parliament`)
`positions[].country`	string	Country of the position
`positions[].from`	string	Start date
`positions[].to`	string	End 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 Range	Confidence	Recommended Action
90-100	Very High	Strong match. Investigate immediately
80-89	High	Likely match. Manual review required
70-79	Medium	Possible match. Review recommended
Below 70	Low	Weak 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:

Class	Description	Examples
`pep-class-1`	Heads of state and senior national government	Presidents, prime ministers, cabinet members
`pep-class-2`	Regional and local government officials	Members of parliament, mayors, governors
`pep-class-3`	Other senior public officials	Senior military officers, judiciary, central bank governors
`pep-class-4`	Associates and family members	Spouses, 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

Type	Source	Jurisdiction
`sanction-sdn`	OFAC Specially Designated Nationals	United States
`sanction-eu`	EU Consolidated Sanctions List	European Union
`sanction-un`	UN Security Council Consolidated List	International
`sanction-hmt`	HM Treasury Consolidated List	United 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

Category	Score	Recommended Action
Sanctions Hit	Any	Immediate escalation. Do not proceed
PEP Class 1-2	Above 80	Enhanced due diligence required
PEP Class 3-4	Above 80	Standard review with ongoing monitoring
Adverse Media	Above 85	Manual review required
Adverse Media	70-85	Review if combined with other risk factors
Watchlist	Any	Immediate escalation

Getting Started

Use-Case Guides

Platform Concepts

Domain Concepts

Data Model

Screening Results

Screening Results

Screening Summary

Example: Clean Result

Example: Result with Hits

Match Details

Media Object

Associate Object

Position Object

Full Match Example

Match Score Interpretation

PEP Classifications

Sanctions List Types

Screening Decision Matrix

​Screening Results

​Screening Summary

​Example: Clean Result

​Example: Result with Hits

​Match Details

​Media Object

​Associate Object

​Position Object

​Full Match Example

​Match Score Interpretation

​PEP Classifications

​Sanctions List Types

​Screening Decision Matrix

Screening Results

Screening Summary

Example: Clean Result

Example: Result with Hits

Match Details

Media Object

Associate Object

Position Object

Full Match Example

Match Score Interpretation

PEP Classifications

Sanctions List Types

Screening Decision Matrix