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. Results are reviewed under Dashboard → Compliance → Screening (requires 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 your organization has no screening provider configured, this is reported honestly as the string "INACTIVE" rather than a fake QUEUED — nothing is screened until a provider is wired up.
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 matches, each a provider-normalized watchlist hit — the matched name, a match score, the match types, and the source list. The dashboard shows the match count in the list and the full match details in a dialog on the screening's detail view.
The provider column names the vendor that produced the result (empty while a check is still pending).
What you see in the dashboard
The screening list shows, per entity: the screening type, its status, the provider, the match count, and when it was screened. Filter by type, status, or provider, search by entity, and narrow by date range. Open a row for the match details.
Empty until there's data:
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.