Following the acquisition, Onfido is now known as Entrust.Read more
Onfido LogoOnfido Logo

Developers

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:

json
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.

FieldDescriptionSub-fields
addressarray of objects
All addresses on file
address_line1
country
postal_code
state_province
town
locator_type
aliasarray of objects
Any names that the person is also known as
alias_name
alias_type
associatearray of objects
Any linked persons, for example family relatives or business partners
entity_name
relationship_direction
relationship_type
attributearray of objects
Information about the person, for example hair color or nationality
attribute_type
attribute_value
date_of_birtharray of DOB objects
All of the date(s) of birth that are on file
eventarray 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_namestring
The name on file
positionarray of strings
The role, country and date of each position
sourcearray of objects
Details about where the information was obtained
source_headline
source_name
source_url

Below is an example Watchlist Enhanced report breakdown:

json
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.

FieldDescription
assetsarray of objects
An array containing objects with URLs to the images of the individual found in the match.
last_updated_utcstring
The date and time the entry was last updated.
mediaarray of objects
An array containing objects with URLs to various media related to the individual, such as images or videos.
namestring
The name on file. Allows for custom cross-referencing of input details against output details.
sourcesarray 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.
typesarray of strings
The type of the source, for example, "pep-class-1".

Below is an example Watchlist AML report breakdown:

json
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:

Watchlist report workflow

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 with OM workflow

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.