Kredibel API
Search
K
Comment on page

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
Example (Full)
Example (Simple)
Example (Recommend)
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
String [array] ["PEP", "RCA", "SIP", "Sanction", "Watchlist", "Crime"]
List of the profile types you want to check
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
{
"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
}
{
"fullName": "Joko Widodo"
}
{
"fullName": "Joko Widodo",
"birthDate": "1961-06-21"
}

Response

Description
Example
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
{
"message": "Watchlist screening",
"data": {
"id": "c6379ffd-2720-49c1-96ee-323fa4f2573e",
"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,
"maxSimilarity": 1.0,
"kredibel": {
"count": 1,
"sanctionCount": 0,
"watchlistCount": 0,
"pepCount": 1,
"rcaCount": 0,
"sipCount": 0,
"maxSimilarity": 1.0,
"result": [
{
"id": "66499d4f2099f613265313cee676cd1b",
"entity": "person",
"name": "Joko Widodo",
"nativeName": "Joko Widodo",
"gender": "male",
"birthPlace": "Surakarta",
"birthDate": "1961-06-21 00:00:00",
"deathDate": null,
"description": "7th President of Indonesia",
"detailDescription": "Please visit https://synapses.sandbox.kredibel.co.id/watchlist/profile/c6379ffd-2720-49c1-96ee-323fa4f2573e/66499d4f2099f613265313cee676cd1b for detail information.",
"updatedAt": null,
"alias": [
"Mulyono",
"Ir. H. Joko Widodo",
"Joko Widodo",
"Мульоно",
"Jokowi",
"Haji Joko Widodo",
"Џокови",
"Джокови",
"Cokovi",
"Džokovi",
"Джокоуи",
"佐科威"
],
"lowAliases": [],
"previousAliases": [],
"maidenNames": [],
"spellingVariationNames": [],
"languageVariationNames": [
"Joko Widodo",
"جوڪو ودودو",
"佐戈",
"Джока Відода",
"Джоко Уидодо",
"Џоко Видодо",
"جوكو ويدودو",
"Ҷоко Видодо",
"Джоко Видодо",
"Τζόκο Ουιντόντο",
"जोको विडोडो",
"ജോക്കോ വിഡൊഡൊ",
"جوکو ویدودو",
"Джоко Відодо",
"ჯოკო ვიდოდო",
"佐科·维多多",
"Ջոկո Վիդոդո",
"জোকো উইদোদো",
"ג'וקו וידודו",
"جوکو ودودو",
"ចូកូ វីដូដូ",
"جوکو ويدودو",
"โจโก วีโดโด",
"Җоко Видодо",
"Coko Vidodo",
"ஜோக்கோ விடோடோ",
"조코 위도도",
"ဂျိုကို ဝီဒိုဒို",
"ਜੋਕੋ ਵਿਡੋਡੋ",
"Džoko Vidodo",
"ジョコ・ウィドド",
"Ճոքօ Ուիտոտօ",
"佐科·維多多"
],
"birthPlaces": [],
"birthDates": [],
"images": [
"https://img.kredibel.co.id/politiface/profile/2e53ed585b97a94246321d56a6d98f00.png"
],
"types": [
"PEP"
],
"profileUrl": "https://synapses.sandbox.kredibel.co.id/watchlist/profile/c6379ffd-2720-49c1-96ee-323fa4f2573e/66499d4f2099f613265313cee676cd1b",
"similarity": 1.0,
"dataset": "PEPs Data",
"matchFields": [
"name",
"birthDate"
]
}
],
"start": 1,
"size": 10
},
"riskLevel": "medium",
"score": -15.0
}
}
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
Example (Full)
Example (Simple)
Example (Recommend)
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
String [array] ["PEP", "RCA", "SIP", "Sanction", "Watchlist", "Crime"]
List of the profile types you want to check
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
{
"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
}
{
"fullName": "Joko Widodo"
}
{
"fullName": "Joko Widodo",
"pseudoBirthDate": "1961-06-21",
"pseudoBirthPlace": "Surakarta",
"pseudoGender": "male",
"pseudoCountry": "Indonesia"
}

Response

Description
Example
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
{
"message": "Watchlist screening",
"data": {
"id": "17fcb342-b7e8-43b5-a12e-e036609d2a97",
"fullName": "Joko Widodo",
"birthPlace": "Surakarta",
"birthDate": "1961-06-21",
"gender": "male",
"country": "Indonesia",
"totalCount": 1,
"totalPseudoCount": 1,
"totalSanctionCount": 0,
"totalPseudoSanctionCount": 0,
"totalWatchlistCount": 0,
"totalPseudoWatchlistCount": 0,
"totalPepCount": 1,
"totalPseudoPepCount": 1,
"totalRcaCount": 0,
"totalPseudoRcaCount": 0,
"totalSipCount": 0,
"totalPseudoSipCount": 0,
"maxSimilarity": 1.0,
"pseudoMaxSimilarity": 0,
"kredibel": {
"count": 1,
"pseudoCount": 1,
"sanctionCount": 0,
"pseudoSanctionCount": 0,
"watchlistCount": 0,
"pseudoWatchlistCount": 0,
"pepCount": 1,
"pseudoPepCount": 1,
"rcaCount": 0,
"pseudoRcaCount": 0,
"sipCount": 0,
"pseudoSipCount": 0,
"maxSimilarity": 1.0,
"pseudoMaxSimilarity": 1.0,
"result": [
{
"id": "66499d4f2099f613265313cee676cd1b",
"entity": "person",
"name": "Joko Widodo",
"nativeName": "Joko Widodo",
"gender": "male",
"birthPlace": "Surakarta",
"birthDate": "1961-06-21 00:00:00",
"deathDate": null,
"description": "7th President of Indonesia",
"detailDescription": "Please visit https://synapses.sandbox.kredibel.co.id/watchlist/profile/17fcb342-b7e8-43b5-a12e-e036609d2a97/66499d4f2099f613265313cee676cd1b for detail information.",
"updatedAt": null,
"alias": [
"Mulyono",
"Ir. H. Joko Widodo",
"Joko Widodo",
"Мульоно",
"Jokowi",
"Haji Joko Widodo",
"Џокови",
"Джокови",
"Cokovi",
"Džokovi",
"Джокоуи",
"佐科威"
],
"lowAliases": [],
"previousAliases": [],
"maidenNames": [],
"spellingVariationNames": [],
"languageVariationNames": [
"Joko Widodo",
"جوڪو ودودو",
"佐戈",
"Джока Відода",
"Джоко Уидодо",
"Џоко Видодо",
"جوكو ويدودو",
"Ҷоко Видодо",
"Джоко Видодо",
"Τζόκο Ουιντόντο",
"जोको विडोडो",
"ജോക്കോ വിഡൊഡൊ",
"جوکو ویدودو",
"Джоко Відодо",
"ჯოკო ვიდოდო",
"佐科·维多多",
"Ջոկո Վիդոդո",
"জোকো উইদোদো",
"ג'וקו וידודו",
"جوکو ودودو",
"ចូកូ វីដូដូ",
"جوکو ويدودو",
"โจโก วีโดโด",
"Җоко Видодо",
"Coko Vidodo",
"ஜோக்கோ விடோடோ",
"조코 위도도",
"ဂျိုကို ဝီဒိုဒို",
"ਜੋਕੋ ਵਿਡੋਡੋ",
"Džoko Vidodo",
"ジョコ・ウィドド",
"Ճոքօ Ուիտոտօ",
"佐科·維多多"
],
"birthPlaces": [],
"birthDates": [],
"images": [
"https://img.kredibel.co.id/politiface/profile/2e53ed585b97a94246321d56a6d98f00.png"
],
"types": [
"PEP"
],
"profileUrl": "https://synapses.sandbox.kredibel.co.id/watchlist/profile/17fcb342-b7e8-43b5-a12e-e036609d2a97/66499d4f2099f613265313cee676cd1b",
"similarity": 1.0,
"dataset": "PEPs Data",
"matchFields": [
"name",
"pseudoBirthDate"
]
}
],
"pseudoResult": [
{
"id": "10c1706b5d65524bb51ef5d258145797",
"entity": "person",
"name": "Joko Widodo",
"nativeName": null,
"gender": "male",
"birthPlace": null,
"birthDate": null,
"deathDate": null,
"description": "Indonesian political candidate",
"detailDescription": "Please visit https://synapses.sandbox.kredibel.co.id/watchlist/profile/17fcb342-b7e8-43b5-a12e-e036609d2a97/10c1706b5d65524bb51ef5d258145797 for detail information.",
"updatedAt": null,
"alias": [
"Joko Widodo"
],
"lowAliases": [],
"previousAliases": [],
"maidenNames": [],
"spellingVariationNames": [],
"languageVariationNames": [
"Joko Widodo"
],
"birthPlaces": [],
"birthDates": [],
"images": [],
"types": [
"PEP"
],
"profileUrl": "https://synapses.sandbox.kredibel.co.id/watchlist/profile/17fcb342-b7e8-43b5-a12e-e036609d2a97/10c1706b5d65524bb51ef5d258145797",
"similarity": 1.0,
"dataset": "PEPs Data",
"matchFields": [
"name",
"pseudoCountry"
]
}
],
"start": 1,
"size": 10
},
"riskLevel": "medium",
"score": -15.0
}
}

Knowledge

Profile Types

List
Code
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.
["PEP", "RCA", "SIP", "Sanction", "Watchlist", "Crime"]

Crime Categories

List
Code
#
Categories
1
corruption
2
terrorism
3
gambling
4
embezzlement
5
fraud
6
money-laundering
7
human-trafficking
8
tax
9
custom
10
human-rights
11
forgery
12
foresty
13
environmental
14
money-counterfeiting
15
currency
16
election
17
banking
18
excise
19
firearm
20
extortion
21
immigration
22
mining
23
economy
24
conservation
25
fence
26
employment
27
trade
28
narcotic
29
theft
30
insult
31
persecution
32
murder
33
perjury
34
pharmaceutical
35
military
36
cybercrime
37
domestic-violence
38
plantation
39
pornography
40
oil-gas
41
fishery
42
consumer-protection
43
cruise
44
fiduciary
45
copyright
46
food
47
decency
48
negligence
49
destruction
50
public-order
51
traffic
52
jinayah
53
marriage-origin
54
child
55
broadcasting
56
electricity
57
government
58
trade
59
education
60
housing
61
industry
["corruption", "terrorism", "gambling", "embezzlement", "fraud", "money-laundering", "human-trafficking", "tax", "custom", "human-rights", "forgery", "foresty", "environmental", "money-counterfeiting", "currency", "election", "banking", "excise", "firearm", "extortion", "immigration", "mining", "economy", "conservation", "fence", "employment", "trade", "narcotic", "theft", "insult", "persecution", "murder", "perjury", "pharmaceutical", "military", "cybercrime", "domestic-violence", "plantation", "pornography", "oil-gas", "fishery", "consumer-protection", "cruise", "fiduciary", "copyright", "food", "decency", "negligence", "destruction", "public-order", "traffic", "jinayah", "marriage-origin", "child", "broadcasting", "electricity", "government", "trade", "education", "housing", "industry"]

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
low
If match with one or more profiles related to RCA
unknown
No matching profiles