Watchlist Screening

You can use the Watchlist Screening module by defining a person's fullName to your JSON request. For a specific search, you can add birthDate and gender as a filter or using a pseudo filter.

Description

A watchlist screening (AML/CFT) is a solution that helps financial institutions and other organizations comply with anti-money laundering (AML) and counter-financing of terrorism (CFT) regulations. This solution allows organizations to search for and identify potential matches against a list of known or suspected individuals and entities involved in money laundering or terrorist financing activities.

Endpoints

Method	URL
POST	$synapses/v1/account/screening

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer YOUR_API_KEY

Using Standard Filter

Request

Description

Field	Type	Description
fullName (Required)	String	Full name of the person you want to check
fullNameFilterTitle	Boolean	If true, then the academic degree on the name input will be filtered e.g. "Drs. Setya Novanto" -> "Setya Novanto" Note: - Default is false
birthDate	Date ("yyyy-mm-dd")	Birthdate of the person
birthPlace	String	Birthplace of the person
gender	String ["male", "female"]	Gender of the person
country	String	Country of the person e.g. Indonesia
searchAliasFields	String [Array] ["nativeName", "alias", "lowAliases", "previousAliases", "spellingVariationNames", "languageVariationNames", "maidenNames"]	Match the fullName query with the fields
searchType	String ["match", "match_exact"]	Type of the searching algorithm Note: - match: fuzzy searching (default, recommended) - exact match: only return 100% match
searchSimilarityAlgorithm	String ["levenshtein", "n-gram"]	Type of the similarity algorithm used for searching Note: - levenshtein: (default, recommended) - n-gram: similarity between "Habibie" and "B.J. Habibie" is 100% match
searchDataSources	String [array] ["kredibel", "dowjones"]	Data source used for searching
profileTypes	String [array] ["PEP", "RCA", "SIP", "Sanction", "Watchlist", "Crime"]	List of the profile types you want to check
crimeCategories	String [array]	Profile related to the category of crime you want to search
ongoingScreening	Boolean	If true, then Kredibel system will do regular monitoring. It means, you'll get notified when there is an update to the result. Note: - Only available for transaction monitoring subscription
minSimilarity	Float (0-1)	The minimum similarity of the result between the query name and the result name e.g. if the treshold is 0.8, then only result has >= 0.8 (80%) match displayed Note: - default treshold is 0.8 - 0.5 = 50%, 1 = 100% match

Example (Full)

{
    "fullName": "Joko Widodo",
    "fullNameFilterTitle": false,
    "birthDate": "1961-06-21",
    "birthPlace": "Surakarta",
    "gender": "male",
    "country": "Indonesia",
    "searchType": "match",
    "searchAliasFields": ["nativeName", "alias", "lowAliases", "previousAliases", "spellingVariationNames", "languageVariationNames", "maidenNames"],
    "searchDataSources": ["kredibel"],
    "searchSimilarityAlgorithm": "levenshtein",
    "profileTypes": ["PEP", "SIP", "RCA", "Sanction", "Watchlist"],
    "ongoingScreening": true,
    "minSimilarity": 0.8
}

Example (Simple)

{
    "fullName": "Joko Widodo"
}

Example (Recommend)

{
    "fullName": "Joko Widodo",
    "birthDate": "1961-06-21"
}

Response

Description

Field	Type	Description
id	String	Unique identifier of PEP search result
fullName	String	Name of the person you search
birthPlace	String	Birthplace of the person you search
birthDate	Date ("yyyy-mm-dd")	Birthdate of the person you search
gender	String	Gender of the person you search
country	String	Country of the person you search
totalCount	Integer	Number of total matches profile
maxSimilarity	Float	Maximum similarity value between your query and matches profile
result	Array	List of matches politically exposed persons
riskLevel	String ["high", "medium", "low", "unknown"]	Level of risk
score	Float	Credibility score

Example

{
    "message": "Watchlist screening",
    "data": {
        "id": "540d9073-62a3-4ea9-8693-ef9e5487e509",
        "fullName": "Joko Widodo",
        "birthPlace": "Surakarta",
        "birthDate": "1961-06-21",
        "gender": "male",
        "country": "Indonesia",
        "totalCount": 1,
        "totalSanctionCount": 0,
        "totalWatchlistCount": 0,
        "totalPepCount": 1,
        "totalRcaCount": 0,
        "totalSipCount": 0,
        "totalCrimeCount": 0,
        "maxSimilarity": 1.0,
        "kredibel": {
            "count": 1,
            "sanctionCount": 0,
            "watchlistCount": 0,
            "pepCount": 1,
            "rcaCount": 0,
            "sipCount": 0,
            "crimeCount": 0,
            "maxSimilarity": 1.0,
            "result": [
                {
                    "id": "66499d4f2099f613265313cee676cd1b",
                    "entity": "person",
                    "name": "Joko Widodo",
                    "nativeName": "Joko Widodo",
                    "gender": "male",
                    "birthPlace": "Surakarta, Central Java, Indonesia",
                    "birthDate": "1961-06-21 00:00:00",
                    "deathDate": null,
                    "description": "Presiden Indonesia ke-7 (2014-Sekarang)",
                    "detailDescription": "Ir. H. Joko Widodo adalah presiden Indonesia yang mulai menjabat sejak tanggal 20 Oktober 2014. Terpilih dalam Pemilu Presiden 2014, Jokowi menjadi presiden Indonesia pertama yang bukan berasal dari elite politik atau militer Indonesia. Dia terpilih bersama Wakil Presiden Jusuf Kalla dan kembali terpilih bersama Wakil Presiden Ma'ruf Amin dalam Pemilu Presiden 2019. Sebelumnya, Jokowi pernah menjabat sebagai gubernur Jakarta sejak 15 Oktober 2012 hingga 16 Oktober 2014 didampingi Basuki Tjahaja Purnama sebagai wakil gubernur. [Wikipedia]",
                    "updatedAt": null,
                    "alias": [
                        "Jokowi",
                        "President Joko Widodo",
                        "Џокови",
                        "佐科·维多多",
                        "Haji Joko Widodo",
                        "佐科威",
                        "Джокови",
                        "Cokovi",
                        "Мульоно",
                        "Джокоуи",
                        "Preisdent Jokowi",
                        "جۆکۆوی",
                        "Džokovi",
                        "Mulyono",
                        "Ir. H. Joko Widodo"
                    ],
                    "lowAliases": [],
                    "previousAliases": [],
                    "maidenNames": [],
                    "spellingVariationNames": [],
                    "languageVariationNames": [
                        "جوکو ویدودو",
                        "Џоко Видодо",
                        "佐科·维多多",
                        "Τζόκο Ουιντόντο",
                        "佐科·維多多",
                        "جوكو ويدودو",
                        "ג'וקו וידודו",
                        "Joko Widodo",
                        "ဂျိုကို ဝီဒိုဒို",
                        "जोको विडोडो",
                        "جوکو ودودو",
                        "Җоко Видодо",
                        "ജോക്കോ വിഡൊഡൊ",
                        "佐戈",
                        "Coko Vidodo",
                        "জোকো উইদোদো",
                        "โจโก วีโดโด",
                        "조코 위도도",
                        "ចូកូ វីដូដូ",
                        "ஜோக்கோ விடோடோ",
                        "Ջոկո Վիդոդո",
                        "جوکو ويدودو",
                        "جوڪو ودودو",
                        "ジョコ・ウィドド",
                        "Джоко Видодо",
                        "Джоко Уидодо",
                        "Ճոքօ Ուիտոտօ",
                        "Džoko Vidodo",
                        "Ҷоко Видодо",
                        "ਜੋਕੋ ਵਿਡੋਡੋ",
                        "جۆکۆ ویدۆدۆ",
                        "ჯოკო ვიდოდო",
                        "Джоко Відодо",
                        "Джока Відода"
                    ],
                    "birthPlaces": [],
                    "birthDates": [],
                    "images": [
                        "https://img.kredibel.co.id/politiface/profile/ac1aff11543cd387827c68a3371c72f0.png"
                    ],
                    "roles": [
                        {
                            "level": null,
                            "endDate": null,
                            "location": null,
                            "roleType": null,
                            "startDate": "2014-10-20 00:00:00",
                            "occupationTitle": "President of Indonesia"
                        },
                        {
                            "level": null,
                            "endDate": "2014-10-20 00:00:00",
                            "location": null,
                            "roleType": null,
                            "startDate": "2012-10-15 00:00:00",
                            "occupationTitle": "Governor of the Special Capital Region of Jakarta"
                        },
                        {
                            "level": null,
                            "endDate": "2012-10-01 00:00:00",
                            "location": null,
                            "roleType": null,
                            "startDate": "2005-07-28 00:00:00",
                            "occupationTitle": "Mayor of Surakarta"
                        }
                    ],
                    "residents": [
                        {
                            "type": "citizenship",
                            "value": "Indonesia"
                        }
                    ],
                    "crimes": [],
                    "sanctions": [],
                    "types": [
                        "PEP"
                    ],
                    "profileUrl": "https://synapses.sandbox.kredibel.com/watchlist/profile/540d9073-62a3-4ea9-8693-ef9e5487e509/66499d4f2099f613265313cee676cd1b",
                    "similarity": 1.0,
                    "dataset": "int-watchlist",
                    "matchFields": [
                        "name",
                        "birthDate"
                    ]
                }
            ],
            "start": 1,
            "size": 10
        },
        "riskLevel": "medium",
        "score": -15.0
    }
}

Using Pseudo Filter (Recommended Method)

If you use a standard filter, data that has no date of birth will not be displayed. With a pseudo filter, you will get data that match with a query or does not have the attributes.

Request

Description

Field	Type	Description
fullName (Required)	String	Full name of the person you want to check
fullNameFilterTitle	Boolean	If true, then the academic degree on the name input will be filtered e.g. "Drs. Setya Novanto" -> "Setya Novanto" Note: - Default is false
pseudoBirthDate	Date ("yyyy-mm-dd")	Birthdate of the person
pseudoBirthPlace	String	Birthplace of the person
pseudoGender	String ["male", "female"]	Gender of the person
pseudoCountry	String	Country of the person e.g. Indonesia
searchAliasFields	String [Array] ["nativeName", "alias", "lowAliases", "previousAliases", "spellingVariationNames", "languageVariationNames", "maidenNames"]	Match the fullName query with the fields
searchType	String ["match", "match_exact"]	Type of the searching algorithm Note: - match: fuzzy searching (default, recommended) - exact match: only return 100% match
searchSimilarityAlgorithm	String ["levenshtein", "n-gram"]	Type of the similarity algorithm used for searching Note: - levenshtein: (default, recommended) - n-gram: similarity between "Habibie" and "B.J. Habibie" is 100% match
searchDataSources	String [array] ["kredibel", "dowjones"]	Data source used for searching
profileTypes	String [array] ["PEP", "RCA", "SIP", "Sanction", "Watchlist", "Crime"]	List of the profile types you want to check
profileCategories	String [array]	Profile related to the category of crime you want to search
ongoingScreening	Boolean	If true, then Kredibel system will do regular monitoring. It means, you'll get notified when there is an update to the result. Note: - Only available for transaction monitoring subscription
minSimilarity	Float (0-1)	The minimum similarity of the result between the query name and the result name e.g. if the treshold is 0.8, then only result has >= 0.8 (80%) match displayed Note: - default treshold is 0.8 - 0.5 = 50%, 1 = 100% match
pseudoMinSimilarity	Float (0-1)	The minimum similarity of the result between the query name and the pseudoResult name Note: - default treshold is 1

Example (Full)

{
    "fullName": "Joko Widodo",
    "fullNameFilterTitle": false,
    "pseudoBirthDate": "1961-06-21",
    "pseudoBirthPlace": "Surakarta",
    "pseudoGender": "male",
    "pseudoCountry": "Indonesia",
    "searchType": "match",
    "searchAliasFields": ["nativeName", "alias", "lowAliases", "previousAliases", "spellingVariationNames", "languageVariationNames", "maidenNames"],
    "searchDataSources": ["kredibel"],
    "searchSimilarityAlgorithm": "levenshtein",
    "profileTypes": ["PEP", "SIP", "RCA", "Sanction", "Watchlist"],
    "ongoingScreening": true,
    "minSimilarity": 0.8,
    "pseudoMinSimilarity": 0.8
}

Example (Simple)

{
    "fullName": "Joko Widodo"
}

Example (Recommend)

{
    "fullName": "Joko Widodo",
    "pseudoBirthDate": "1961-06-21",
    "pseudoBirthPlace": "Surakarta",
    "pseudoGender": "male",
    "pseudoCountry": "Indonesia"
}

Response

Description

Field	Type	Description
id	String	Unique identifier of PEP search result
fullName	String	Name of the person you search
birthPlace	String	Birthplace of the person you search
birthDate	Date ("yyyy-mm-dd")	Birthdate of the person you search
gender	String	Gender of the person you search
country	String	Country of the person you search
totalCount	Integer	Number of total matches profile
maxSimilarity	Float	Maximum similarity value between your query and matches profile
pseudoMaxSimilarity	Float	Maximum similarity value between your query and pseudo matches profile
result	Array	List of matches politically exposed persons
pseudoResult	Array	List of matches politically exposed persons with pseudoFilter
riskLevel	String ["high", "medium", "low", "unknown"]	Level of risk
score	Float	Credibility score

Example

{
    "message": "Watchlist screening",
    "data": {
        "id": "bbfd43f3-ae91-4fd0-ba62-eaa177282aff",
        "fullName": "Joko Widodo",
        "birthPlace": "Surakarta",
        "birthDate": "1961-06-21",
        "gender": "male",
        "country": "Indonesia",
        "totalCount": 1,
        "totalPseudoCount": 0,
        "totalSanctionCount": 0,
        "totalPseudoSanctionCount": 0,
        "totalWatchlistCount": 0,
        "totalPseudoWatchlistCount": 0,
        "totalPepCount": 1,
        "totalPseudoPepCount": 0,
        "totalRcaCount": 0,
        "totalPseudoRcaCount": 0,
        "totalSipCount": 0,
        "totalPseudoSipCount": 0,
        "totalCrimeCount": 0,
        "totalPseudoCrimeCount": 0,
        "maxSimilarity": 1.0,
        "pseudoMaxSimilarity": 0,
        "kredibel": {
            "count": 1,
            "pseudoCount": 0,
            "sanctionCount": 0,
            "pseudoSanctionCount": 0,
            "watchlistCount": 0,
            "pseudoWatchlistCount": 0,
            "pepCount": 1,
            "pseudoPepCount": 0,
            "rcaCount": 0,
            "pseudoRcaCount": 0,
            "sipCount": 0,
            "pseudoSipCount": 0,
            "crimeCount": 0,
            "pseudoCrimeCount": 0,
            "maxSimilarity": 1.0,
            "pseudoMaxSimilarity": 0,
            "result": [
                {
                    "id": "66499d4f2099f613265313cee676cd1b",
                    "entity": "person",
                    "name": "Joko Widodo",
                    "nativeName": "Joko Widodo",
                    "gender": "male",
                    "birthPlace": "Surakarta, Central Java, Indonesia",
                    "birthDate": "1961-06-21 00:00:00",
                    "deathDate": null,
                    "description": "Presiden Indonesia ke-7 (2014-Sekarang)",
                    "detailDescription": "Ir. H. Joko Widodo adalah presiden Indonesia yang mulai menjabat sejak tanggal 20 Oktober 2014. Terpilih dalam Pemilu Presiden 2014, Jokowi menjadi presiden Indonesia pertama yang bukan berasal dari elite politik atau militer Indonesia. Dia terpilih bersama Wakil Presiden Jusuf Kalla dan kembali terpilih bersama Wakil Presiden Ma'ruf Amin dalam Pemilu Presiden 2019. Sebelumnya, Jokowi pernah menjabat sebagai gubernur Jakarta sejak 15 Oktober 2012 hingga 16 Oktober 2014 didampingi Basuki Tjahaja Purnama sebagai wakil gubernur. [Wikipedia]",
                    "updatedAt": null,
                    "alias": [
                        "Jokowi",
                        "President Joko Widodo",
                        "Џокови",
                        "佐科·维多多",
                        "Haji Joko Widodo",
                        "佐科威",
                        "Джокови",
                        "Cokovi",
                        "Мульоно",
                        "Джокоуи",
                        "Preisdent Jokowi",
                        "جۆکۆوی",
                        "Džokovi",
                        "Mulyono",
                        "Ir. H. Joko Widodo"
                    ],
                    "lowAliases": [],
                    "previousAliases": [],
                    "maidenNames": [],
                    "spellingVariationNames": [],
                    "languageVariationNames": [
                        "جوکو ویدودو",
                        "Џоко Видодо",
                        "佐科·维多多",
                        "Τζόκο Ουιντόντο",
                        "佐科·維多多",
                        "جوكو ويدودو",
                        "ג'וקו וידודו",
                        "Joko Widodo",
                        "ဂျိုကို ဝီဒိုဒို",
                        "जोको विडोडो",
                        "جوکو ودودو",
                        "Җоко Видодо",
                        "ജോക്കോ വിഡൊഡൊ",
                        "佐戈",
                        "Coko Vidodo",
                        "জোকো উইদোদো",
                        "โจโก วีโดโด",
                        "조코 위도도",
                        "ចូកូ វីដូដូ",
                        "ஜோக்கோ விடோடோ",
                        "Ջոկո Վիդոդո",
                        "جوکو ويدودو",
                        "جوڪو ودودو",
                        "ジョコ・ウィドド",
                        "Джоко Видодо",
                        "Джоко Уидодо",
                        "Ճոքօ Ուիտոտօ",
                        "Džoko Vidodo",
                        "Ҷоко Видодо",
                        "ਜੋਕੋ ਵਿਡੋਡੋ",
                        "جۆکۆ ویدۆدۆ",
                        "ჯოკო ვიდოდო",
                        "Джоко Відодо",
                        "Джока Відода"
                    ],
                    "birthPlaces": [],
                    "birthDates": [],
                    "images": [
                        "https://img.kredibel.co.id/politiface/profile/ac1aff11543cd387827c68a3371c72f0.png"
                    ],
                    "roles": [
                        {
                            "level": null,
                            "endDate": null,
                            "location": null,
                            "roleType": null,
                            "startDate": "2014-10-20 00:00:00",
                            "occupationTitle": "President of Indonesia"
                        },
                        {
                            "level": null,
                            "endDate": "2014-10-20 00:00:00",
                            "location": null,
                            "roleType": null,
                            "startDate": "2012-10-15 00:00:00",
                            "occupationTitle": "Governor of the Special Capital Region of Jakarta"
                        },
                        {
                            "level": null,
                            "endDate": "2012-10-01 00:00:00",
                            "location": null,
                            "roleType": null,
                            "startDate": "2005-07-28 00:00:00",
                            "occupationTitle": "Mayor of Surakarta"
                        }
                    ],
                    "residents": [
                        {
                            "type": "citizenship",
                            "value": "Indonesia"
                        }
                    ],
                    "crimes": [],
                    "sanctions": [],
                    "types": [
                        "PEP"
                    ],
                    "profileUrl": "https://synapses.sandbox.kredibel.com/watchlist/profile/bbfd43f3-ae91-4fd0-ba62-eaa177282aff/66499d4f2099f613265313cee676cd1b",
                    "similarity": 1.0,
                    "dataset": "int-watchlist",
                    "matchFields": [
                        "name",
                        "pseudoBirthDate"
                    ]
                }
            ],
            "pseudoResult": [],
            "start": 1,
            "size": 10
        },
        "riskLevel": "medium",
        "score": -15.0
    }
}

Knowledge

Profile Types

List

Types	Definition
PEP	A Politically Exposed Person (PEP) is an individual who holds a prominent public position or has held such a position in the recent past. This can include government officials, high-ranking military officers, heads of state-owned enterprises, and leaders of political parties.
RCA	Relative and Close Associates (RCA) refers to Individuals who are closely related to a Politically Exposed Person (PEP). This can include immediate family members, such as spouses, children, and parents, as well as individuals with close business or personal relationships with the PEP. These individuals are considered high-risk for involvement in money laundering or terrorist financing due to their association with the PEP.
SIP	A Special Interest Person is an individual or entity that, while not necessarily a PEP, possesses a higher risk profile due to their involvement in industries or activities that are susceptible to money laundering or terrorist financing. These could include sectors like gambling, real estate, and non-profit organizations. SIPs are subject to closer scrutiny during AML/CFT procedures.
Sanction	Sanctions are punitive measures imposed by governments, international organizations, or regulatory bodies to deter and punish individuals, entities, or countries that have violated laws, regulations, or international agreements. Sanctions are typically imposed to address specific concerns, such as human rights abuses, proliferation of weapons of mass destruction, or support for terrorism.
Watchlist	A watchlist is a database maintained by financial institutions, law enforcement agencies, and regulatory bodies to identify individuals, entities, or organizations that are suspected or confirmed to be involved in money laundering, terrorist financing, or other illicit activities. Watchlists are used to enhance due diligence and screening processes.
Crime	Other criminal categories other than those related to AML/CFT.

Code

["PEP", "RCA", "SIP", "Sanction", "Watchlist", "Crime"]

Crime Categories

List

#	Categories	Version
1	corruption	1.0
2	terrorism	1.0
3	national-security	1.1
4	gambling	1.0
5	embezzlement	1.0
6	fraud	1.0
7	money-laundering	1.0
8	human-trafficking	1.0
9	tax	1.0
10	customs	1.1
11	human-rights	1.0
12	forgery	1.0
13	foresty	1.0
14	environmental	1.0
15	illegal-logging	1.1
16	coastal-zone	1.1
17	money-counterfeiting	1.0
18	currency	1.0
19	election	1.0
20	banking	1.0
21	excise	1.0
22	narcotic	1.0
23	theft	1.0
24	firearm	1.0
25	defamation	1.1
26	persecution	1.0
27	murder	1.0
28	extortion	1.0
29	perjury	1.0
30	immigration	1.0
31	mining	1.0
32	pharmaceutical	1.0
33	cybercrime	1.0
34	domestic-violence	1.0
35	plantation	1.0
36	pornography	1.0
37	oil-gas	1.0
38	fishery	1.0
39	consumer-protection	1.0
40	cruise	1.0
41	fiduciary	1.0
42	copyright	1.0
43	food	1.0
44	economy	1.0
45	conservation	1.0
46	fence	1.0
47	obscenity	1.1
48	negligence	1.0
49	destruction	1.0
50	public-order	1.0
51	traffic	1.0
52	jinayah	1.0
53	marriage-origin	1.0
54	chins	1.1
55	children	1.1
56	migrant-worker	1.0
57	employment	1.0
58	broadcasting	1.0
59	electricity	1.0
60	local-government	1.1
61	trade-secret	1.1
62	education	1.0
63	housing	1.0
64	industry	1.0
65	military-desertion	1.1
66	military-obscenity	1.1
67	military-subordinate	1.1

Deprecated

#	Deprecated Categories	New Categories
1	custom	customs
2	insult	defamation
3	decency	obscenity
4	child	children, chins
5	government	local-government
6	trade	trade-secret
7	military	military-desertion, military-obscenity, military-subordinate

Code

["corruption", "terrorism", "national-security", "gambling", "embezzlement", "fraud", "money-laundering", "human-trafficking", "tax", "customs", "human-rights", "forgery", "foresty", "environmental", "illegal-logging", "coastal-zone", "money-counterfeiting", "currency", "election", "banking", "excise", "narcotic", "theft", "firearm", "defamation", "persecution", "murder", "extortion", "perjury", "immigration", "mining", "pharmaceutical", "cybercrime", "domestic-violence", "plantation", "pornography", "oil-gas", "fishery", "consumer-protection", "cruise", "fiduciary", "copyright", "food", "economy", "conservation", "fence", "obscenity", "negligence", "destruction", "public-order", "traffic", "jinayah", "marriage-origin", "migrant-worker", "employment", "broadcasting", "electricity", "local-government", "trade-secret", "education", "housing", "industry", "military-desertion", "military-obscenity", "military-subordinate"]

Risk Level

Risk	Description
high	If match with one or more profiles related to Sanction, Watchlist, or SIP
medium	If match with one or more profiles related to PEP or Crime
low	If match with one or more profiles related to RCA
unknown	No matching profiles

Ongoing Screening

You can set ongoing screening feature if:

• You are subscribed to transaction monitoring

• minSimilarity >= 0.8

• Using birthDate or pseudoBirthDate in params