Watchlist for Businesses

In today's rapidly evolving digital landscape, ensuring security and compliance within various processes has become paramount. The Watchlist module, a sophisticated processing node, stands at the forefront of this initiative. Designed to integrate seamlessly into workflows, this module empowers users with the ability to specify detailed search criteria through comprehensive module configuration options.

This user guide provides an in-depth look at how to configure and utilize the Watchlist module effectively, outlining the prerequisites for data collection, the nuances of module configuration, and the steps for subscribing to updates. With a focus on optimizing search results through various filters and keeping users informed of any changes, this guide serves as a comprehensive resource for integrating the Watchlist module into your workflow, ensuring enhanced security and compliance with regulatory standards.

Integration

Watchlist belongs to processing nodes. Module configuration gives various options to specify different search criteria. Given that watchlist is a processing module, it needs to be added to the workflow tree after user data is collected. Watchlist for Business feature is designed to help corporations navigate due diligence and compliance. This solution allows businesses to conduct due diligence on vendors, suppliers, and partners to ensure they are not associated with financial crimes or sanctions, thereby reducing the risk of legal and financial exposure.

📘

Requisites

Module Configuration

Note: Watchlist for Business can be used alongside KYB or independently.

Conditions

The Watchlists module is an advanced feature that allows organizations to screen business entities against various international and national watchlists during the identity verification process.

Watchlist results can be used in conditions that affect the further use of these features or session result:

Single Session Dashboard Results

They are available on Single Session view under Business tab → Watchlist Result_. Clicking on Click here to discover more takes you to detailed view of all matches, hits with information where the user was found.

Watchlist result

Subscribe for updates

You can subscribe to updates on the search results and received notification via webhooks.

To configure a webhook for notifying when the global watchlist has updates, you'll need to set up a POST request to a client-defined URL. Configure your webhook url under on Omni Dashboard Configuration → Webhooks: Watchlist update webhook URL. This request will include a body with three mandatory fields:

These fields are used to identify and retrieve the new search result via API - Updated watchlist result.

When performing watchlist search, user should provide “subscribe”:true body parameter and webhook url in Organization’s configuration is set. In the response field ref is of interest, and should be saved by the user.

When the search is updated (entities are updated-added-removed) Incode will send the previously saved ref to the user’s webhook to inform the search is updated.

When the user wants to pull the newest data for the updated search, they use /omni/updated-watchlist-result?ref=[referenceId] endpoint.

Steps

Webhook configuration

Business watchlist request:

Direct API Approach

All module configurations and user data can be forwarded directly in the request for performing watchlist for business search. This will override existing configuration and data collected about the company.

API Authentication

All endpoints require authentication headers to be specified as stated in Incode API Documentation

Watchlist result

POST /omni/businessWatchlist-result

Note: Endpoint can have empty body {} and in that case information will be pulled from module configuration and session details.

The request body must have the business name and country code(s).

REQUEST EXAMPLE

Method: POST
Endpoint: /omni/businessWatchlist-result
Request Body:
{
  "businessName": "Acme Corporation",
  "countryCodes": ["US", "GB", "DE"],
  "watchlistTypes": ["sanction", "pep", "adverse-media"],
  "fuzziness": 0.8,
  "subscribe": true,
  "searchProfile": "default-profile"
}

{
  "businessName": "Acme Corporation"
}

Usually, for general purpose this should be enough but it means that request will be processed for all countries, internally defined default profile and default values in general and without subscription.

RESPONSE EXAMPLE
{
"content": {
"data": {
"id": 1697044869,
"ref": "1712607640-1sEYsOYW",
"searcher_id": 14876,
"assignee_id": 14876,
"filters": {
"country_codes": ["DE"],
"entity_type": "company",
"exact_match": false,
"fuzziness": 1,
"remove_deceased": 0,
"types": ["sanction","warning"]
},
"match_status": "potential_match",
"risk_level": "unknown",
"search_term": "Eberkraft",
"total_hits": 38,
"total_matches": 38,
"updated_at": "2025-09-05 08:41:14",
"created_at": "2025-09-05 08:41:14",
"tags": [],
"limit": 100,
"offset": 0,
"share_url": "https://app.eu.complyadvantage.com/public/search/1712607640-1sEYsOYW/573af167e1a0",
"hits": [
{
"doc": {
"aka": [
{
"name": "Limited Liability Company Eberkraft Group Rus"
}
// Truncated for brevity, include all names as in your example
],
"associates": [
{
"association": "Linked to",
"name": "Nick Doe"
},
{
"association": "Linked to",
"name": "Jane Does"
}
// Truncated for brevity, includes all associates
],
"fields": [
{
"name": "Country",
"source": "ukraine-national-agency-on-corruption-prevention-sanctions",
"value": "Russian Federation"
},
{
"name": "Original Country Text",
"source": "country-national-agency-on-corruption-prevention-sanctions",
// Truncated for brevity, includes varios terms found
],
"id": "1CLBTB5OU7NL55O",
"last_updated_utc": "2022-11-14T09:57:06Z",
"name": "Limited Liability Company Eberkraft Group Rus",
"sources": [
"country-sanctions-national-security-and-defense-council-nsdr-special-economic-and-other-restrictive-measures-organisations"
],
"types": [
"sanction"
]
},
"is_whitelisted": false,
"match_types": [
"aka_exact"
],
"match_types_details": [
{
"aml_types": ["sanction"],
"matching_name": "Limited Liability Company Eberkraft Group Rus",
"name_matches": [
{
"match_types": ["exact_match"],
"query_term": "Eberkraft"
}
],
"secondary_matches": [],
"sources": [
"country Sanctions National Security and Defense Council (NSD) Special Economic and Other Restrictive Measures – Organisations (Suspended)"
]
}
],
"score": 1.7
}
}
// Truncated for brevity, includes other hits
]
}
},
"status": "success"
}

Provisioning

To obtain comprehensive details on the pricing and provisioning of the Watchlist for business module, we encourage you to contact our dedicated customer support team. Our experts are on hand to assist you in tailoring a search profile that precisely meets your unique requirements, guiding you through the most effective configuration options for your specific use case. This personalized approach ensures that you leverage the full potential of the Watchlist for business module, optimizing your workflows for security and compliance. Our team is committed to providing you with the support and insights needed to make informed decisions, ensuring a seamless integration process.