Screening

Screening checks your entities against watchlists (sanctions lists, politically-exposed-person (PEP) registers, adverse media, and, when wallet addresses are attached, sanctioned crypto wallets) and records any matches. In the dashboard, open a customer and select Risk to see their compliance intelligence. Results requiring attention also appear in the Review Queue. Both require the screening:read permission.

Enrolment

An entity is enrolled in screening automatically when you register it via the Identity Hub. The registration response echoes the screening state:

json
"screening": { "status": "QUEUED", "types": ["SANCTIONS", "PEP", "ADVERSE_MEDIA", "WALLET"] }

When screening is not active for your organisation, this is reported honestly as the string "INACTIVE" rather than a fake QUEUED. Nothing is screened until the service is active.

A verification enrols the person (or business) when it passes, but only if the workflow it ran includes AML Screening. A workflow with AML Screening turned off enrols nobody, so nothing is screened or charged for screening. Its Ongoing monitoring setting decides whether the enrolment keeps re-screening or runs once. A verification submitted without a workflow enrols everyone who passes.

Types

TypeChecks against
SANCTIONSGovernment and international sanctions lists.
PEPPolitically-exposed-person registers.
ADVERSE_MEDIANegative news and adverse-media sources.
WALLETThe entity's attached crypto wallet addresses, checked against sanctioned-wallet data (e.g. OFAC SDN listings). Enrolled only when the profile carries at least one walletAddresses entry; one screen covers all attached addresses, and a changed address set re-screens promptly instead of waiting for the cadence.

Statuses

StatusMeaning
QUEUEDEnrolled; the initial run hasn't completed.
CLEARNo matches found.
POTENTIAL_MATCHOne or more possible matches need review.
CONFIRMEDA match has been confirmed.

Matches

A screening that isn't CLEAR carries one or more customer-safe matches: the matched name or wallet, a match score, match types, aliases and selected identity evidence. Internal source identity, raw watchlist records and internal provenance are not exposed.

What you see in the dashboard

Customer Risk shows the latest screening type, status, match count, when it was last checked, and the next monitoring check when one is scheduled. Open an evidence row to inspect the customer-safe match details and adjudication state. The detail view keeps a newest-first review history with the outcome, recorded time, review note and score at the time of the decision. It does not expose reviewer IDs, internal source names, raw datasets or source records. Screening evidence that changes a risk decision is also linked from the decision, transaction, or investigation where it mattered.

When there is no recorded evidence:

Screening results appear here once entities are enrolled in ongoing sanctions / PEP / adverse-media screening.

  • Identity Hub API: where enrolment happens.
  • Compliance overview: how screening fits the wider FRAML picture.
  • GET /api/v1/monitoring/screenings/{screeningId}: retrieve the current customer-safe screening resource linked by a webhook.