Advanced Watchlist Screening

Advanced Watchlist Screening screens end users against global and regional sanctions, watchlists, and politically exposed persons (PEPs). It can be used as part of an identity verification workflow or as a standalone service using Prepared Data.

Prerequisite (Optional)

When creating or updating an account, you can optionally provide a searchProfile in the watchlistScreening configuration. If provided, this value overrides the default search profile configured in the Watchlist Screening settings. Contact your Jumio Account Manager for more information.

Example

"capabilities": {
 "watchlistScreening": {
   "searchProfile": "abcd1234-xx11-yy22-zz33-a1b2-a1b2c3d4e5f6"
 }
}

Dependencies

Advanced Watchlist Screening can be used with ID or ID Verification services. In these workflows, the required personal information is obtained from the uploaded identity document. The following capabilities are required:

• Usability
• Extraction
• Image Checks

Prepared Data

Advanced Watchlist Screening can also be used as a standalone service by providing the following values as Prepared Data:

Key	Type	Mandatory	Description
firstName	string	Yes	End user's first name.
lastName	string	Yes	End user's last name.
dateOfBirth	string	No	Date of birth in YYYY-MM-DD format.
address.country	string	No	Country in ISO Alpha-3 format.

Preset Workflows

The following workflows are preset to use Advanced Watchlist Screening:

Workflow	Description
11217	Uses data extracted from the identity document.
11218	Uses API Prepared Data.

note

• Workflow 11217 is designed for use cases where customer information is obtained from an identity document.
• Workflow 11218 is designed for use cases where customer information is provided directly through the API using Prepared Data.

Decision Details

The screening result determines the capability decision.

Decision Type	Label	Description
PASSED	OK	The end user was not found on any watchlists.
WARNING	ALERT	The end user was found on one or more watchlists.

Not Executed

The capability may return NOT_EXECUTED when the screening cannot be completed.

Label	Description
PRECONDITION_NOT_FULFILLED	Required data from another capability is not available.
TECHNICAL_ERROR	An error prevented the screening from being completed.
NOT_ENOUGH_DATA	There is not enough data to perform the screening.
VALIDATION_FAILED	Validation failed during processing.
INVALID_MERCHANT_SETTINGS	Invalid account settings were detected.
NO_VALID_ID_CREDENTIAL	No valid identity document was provided.
EXTRACTION_NOT_DONE	Data extraction was not performed.

For more information about how Jumio handles capability results, see How Jumio Handles Results.

Retrieval Example

Advanced Watchlist Screening results are returned in the watchlistScreening object within the capabilities section of the Retrieval API response.

Example

"capabilities": {
 "watchlistScreening": [
   {
     "id": <YOUR UUID>,
     "credentials": [
       {
         "id": <YOUR UUID>,
         "category": "DATA"
       }
     ],
     "decision": {
       "type": "WARNING",
       "details": {
         "label": "ALERT"
       }
     },
     "data": {
       "screeningResult": "HAS_PROFILES",
       "matchCategories": [
         "PEP Class 2",
         "PEP Class 1",
         "Terrorist Financing",
         "Non-Financial Criminality",
         "Kidnapping & Hostage Taking",
         "Organized Groups & Racketeering",
         "Robbery & Theft",
         "Other Regulation Breach"
       ],
       "screeningDate": "2026-08-18T18:46:57.925Z",
       "customerIdentifier": "01a01632.....",
       "screeningUrl": "https://mesh.complyadvantage.com/customers/<customerIdentifier>"
     }
   }
 ]
}

Response Fields

Field	Description
id	Unique identifier for the Advanced Watchlist Screening capability.
credentials	Identifies the data used to perform the screening.
decision.type	Overall capability decision, such as PASSED or WARNING.
decision.details.label	Customer-facing decision label, such as OK or ALERT.
screeningResult	Overall screening result. Possible values are HAS_PROFILES or NO_PROFILES.
matchCategories	List of risk categories associated with the screening results.
screeningDate	Date and time when the screening was performed. The timestamp is in UTC.
customerIdentifier	Unique identifier associated with the screened customer.
screeningUrl	See the table below for the screening results.

Screening Results

screeningResult	Decision	Description
NO_PROFILES	PASSED	No matching profiles were identified.
HAS_PROFILES	WARNING	One or more matching profiles were identified.

Data

The following screening information is available in the transaction response:

Key	Type	Description
screeningDate	string	UTC timestamp indicating when the screening was performed.
customerIdentifier	string	Unique identifier associated with the screened customer.
screeningUrl	string	URL to the screening results.
screeningResult	string	Overall screening result: HAS_PROFILES or NO_PROFILES.
matchCategories	array	List of risk categories associated with the identified matches. See the table below.

matchCategories

matchCategories Values
AML/CFT Regulation Breach
Arms Trafficking
Bribery & Corruption
Currency Counterfeiting
Cybercrime
Direct Sanctions Exposure
Dual-Use Goods
Environmental Crime
Extortion
Financial Difficulty
Financial Regulation Breach
Forgery
Fraud
Human Trafficking & Migrant Smuggling
Indirect Sanctions Exposure
Insider Trading & Market Manipulation
Kidnapping & Hostage Taking
Maritime & Aviation Piracy
Most Wanted
Murder & Bodily Harm
Narcotics & Psychotropics Trafficking
Non-Financial Criminality
Organized Groups & Racketeering
Other Regulation Breach
PEP Class 1
PEP Class 2
PEP Class 3
PEP Class 4
Product Counterfeiting & Piracy
Robbery & Theft
Sexual Exploitation
Smuggling
Stolen Goods Trafficking
Tax Crimes
Terrorist Financing
Unspecified PEP Class
Unspecified Predicate Offenses
Unspecified Proliferation Financing
Unspecified Regulatory & Reputational
Weapons of Mass Destruction