Watchlist reports
Start here
This guide presents a technical overview of our Watchlist reports, available for integration through Workflow Studio.
Introduction
Watchlist reports verify an applicant's records against a range of global watchlists, including:
- Sanctions - government and international organisations' sanctions lists
- Politically Exposed Persons (PEPs) - proprietary database of PEPs sourced from government lists, websites and other media sources
- Monitored Lists - law enforcement and regulatory bodies monitored lists (including terrorism, money laundering and most wanted lists)
- Adverse Media - negative events reported by publicly and generally available media sources
Watchlist report variants
There are five different variants of Watchlist report, each with its own structure of results and result breakdowns. The report's properties
attribute contains a records
field, which is an array of the various lists that have returned matches.
If no match is found against the applicant, the records
field will be an empty array and the overall report result
will be clear
.
If one or more matches are found, each match will be returned under records
and the overall report result
will be consider
.
Watchlist Standard
The Watchlist Standard report returns matches against the following three breakdowns:
sanction
politically_exposed_person
legal_and_regulatory_warnings
Below is an example Watchlist Standard report breakdown:
1"breakdown": {2 "sanction": {3 "result": "clear"4 },5 "politically_exposed_person": {6 "result": "clear"7 },8 "legal_and_regulatory_warnings": {9 "result": "clear"10 }11 }
Watchlist Enhanced
The Watchlist Enhanced report returns matches against the following four breakdowns:
sanction
politically_exposed_person
monitored_lists
adverse_media
The possible match values for Watchlist Enhanced are detailed in the table below. As matches are returned based on the available information, none of these properties are guaranteed to be present in the response.
Field | Description | Sub-fields |
---|---|---|
address | array of objects All addresses on file | address_line1 country postal_code state_province town locator_type |
alias | array of objects Any names that the person is also known as | alias_name alias_type |
associate | array of objects Any linked persons, for example family relatives or business partners | entity_name relationship_direction relationship_type |
attribute | array of objects Information about the person, for example hair color or nationality | attribute_type attribute_value |
date_of_birth | array of DOB objects All of the date(s) of birth that are on file | |
event | array of objects Information about events that have occurred to the person, for example deportation or arrest | category event_date event_description source (source_date, source_format, source_name) sub_category |
full_name | string The name on file | |
position | array of strings The role, country and date of each position | |
source | array of objects Details about where the information was obtained | source_headline source_name source_url |
Below is an example Watchlist Enhanced report breakdown:
1"breakdown": {2 "politically_exposed_person": {3 "result": "clear"4 },5 "sanction": {6 "result": "clear"7 },8 "adverse_media": {9 "result": "clear"10 },11 "monitored_lists": {12 "result": "clear"13 }14 }
Watchlist AML
The Watchlist Enhanced report represents a superset of the Watchlist Standard report and returns matches against the following four breakdowns:
sanction
politically_exposed_person
legal_and_regulatory_warnings
adverse_media
The Watchlist AML report is 6AMLD compliant.
The possible match values for Watchlist AML are detailed in the table below. As matches are returned based on the available information, none of these properties are guaranteed to be present in the response.
Field | Description |
---|---|
assets | array of objects An array containing objects with URLs to the images of the individual found in the match. |
last_updated_utc | string The date and time the entry was last updated. |
media | array of objects An array containing objects with URLs to various media related to the individual, such as images or videos. |
name | string The name on file. Allows for custom cross-referencing of input details against output details. |
sources | array of objects An array containing objects with information about where the data was obtained, for example, "PEPs list" and all related information from each source. |
types | array of strings The type of the source, for example, "pep-class-1". |
Below is an example Watchlist AML report breakdown:
1"breakdown": {2 "sanction": {3 "result": "clear"4 },5 "politically_exposed_person": {6 "result": "clear"7 },8 "legal_and_regulatory_warnings": {9 "result": "clear"10 },11 "adverse_media": {12 "result": "clear"13 }14 }
Watchlist Sanctions only
The Watchlist Sanctions Only report is a subset of the Watchlist Standard report, returning matches against the sanction
breakdown only.
Watchlist PEPs only
The Watchlist PEPs Only report is a subset of the Watchlist Standard report, returning matches against the politically_exposed_person
breakdown only.
Watchlist Standard and Watchlist AML Report tasks
Similar to other reports, to run a Watchlist report, it should be added into your Studio workflow.
Workflow Studio caters for all five variants of Watchlist report. If your account is configured for Watchlist Standard, Sanctions only or PEPs only, reports are run by adding a Watchlist Standard Report task from the Studio Workflow Builder. If your account is configured for Watchlist Enhanced or Watchlist AML, reports are run by adding a Watchlist AML Report task from the Studio Workflow Builder.
When building a Studio workflow, input data for these tasks can be received from the workflow input data, a Document Report or Autofill task, as well as information extracted from a Profile Data Capture task.
Note that the applicant's first name and last name are mandatory for Watchlist reports. Submitting the applicant's date of birth and address is optional, but both are recommended as they narrow the search for the relevent individual.
Below you will find an illustrated example of a Studio workflow running a Watchlist report:
More information about report tasks can be found in our Studio Product Guide.
Ongoing Monitoring
Introduction
For the Watchlist AML and Watchlist Standard report types, you can also enable Ongoing Monitoring, which provides continuous screening of a specified applicant to ensure continuous compliance. Following an initial Watchlist report, the applicant will be continuously checked against the relevant records, notifying you of any change in status.
If you are interested in using the Ongoing Monitor feature, it must first be enabled for your account. Please reach out to your CSM or email our Client Support team.
Note: Concurrent checks will also be enabled for your account, as Ongoing Monitoring can lead to multiple verification checks running against the same applicant.
Watchlist Ongoing Monitoring task
Ongoing Monitoring can be configured by adding a Watchlist Ongoing Monitoring task to a Studio workflow.
The output of a Watchlist Ongoing Monitoring task does not include the associated Watchlist Report results. As a result, if you have logic that depends on these results, we recommend adding a Watchlist Report task to your workflow, then add the Watchlist Ongoing Monitoring task to get updates if the user's records changed.
Below you will find an illustrated example of a Studio workflow running a Watchlist report with an Ongoing Monitor:
Watchlist Report task results
Watchlist reports results
If you want to obtain the specific outputs from the Watchlist Report task via the Entrust Identity Verification API (for example, the overall report result or breakdown results), you can manage this by configuring the Workflow Output in the Studio Workflow Builder.
You can refer to our Studio product guide for more information on Workflow Output configuration. Once set up, the output can be consumed by making a Retrieve Workflow Run call to the API. Report results are found in the output
property.
Workflow Run results can also be accessed on the results tab of your Studio Dashboard.
Ongoing Monitor notifications
In order to be notified of any changes in an applicant's watchlist status, you can configure a webhook, using the watchlist_monitor.matches_updated
event.
More details regarding webhooks can be found in our API reference documentation.
You can also review the status of Ongoing Monitors on the Ongoing Monitors page of your Studio Dashboard.
FAQs
What happens when the information of an Applicant that is set up for Ongoing Monitoring is updated - will the Monitor be updated as well?
Ongoing Monitoring will not be updated with the new Applicant information. You will continue to receive updates based on the original Applicant details during the creation of an Applicant.
To update a Monitor, you can delete the existing Monitor and create a new Monitor for the updated Applicant. Please refer to our API reference documentation.
How does ongoing monitoring impact rolling deletion of applicant data setup in my account?
Rolling deletion will be disabled for the customer at the account level.