On this page
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:
"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
| Type | Checks against |
|---|---|
SANCTIONS | Government and international sanctions lists. |
PEP | Politically-exposed-person registers. |
ADVERSE_MEDIA | Negative news and adverse-media sources. |
WALLET | The 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
| Status | Meaning |
|---|---|
QUEUED | Enrolled; the initial run hasn't completed. |
CLEAR | No matches found. |
POTENTIAL_MATCH | One or more possible matches need review. |
CONFIRMED | A 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.
Related
- 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.