WatchList is a PEP and Sanction list lookup for due diligence checks. The service sees if a person is listed on any PEP or Sanction lists.
PEP (Politically Exposed Person) means “in a prominent public position or a close relative of someone who is.”
Note that a PEP match can be a “PEPs by relation”, also known as RCA (Relatives or Close Associates).
API
POST to https://env
.zignsec.com/v2/ekyc/watchlist/nordic (uses Nordic provider)
POST to https://env
.zignsec.com/v2/ekyc/watchlist/global (uses global provider)
POST to https://env
.zignsec.com/v2/ekyc/watchlist/globalpremium (uses global provider with C6/Adverse Media check included)
where env
stands for environment and can be either API for production or test.
Deprecated:
POST to https://env
.zignsec.com/v2/ekyc/watchlist/global2 (deprecated PEP/Sanction call to alternative global provider)
POST to https://env
.zignsec.com/v2/ekyc/watchlist (obsolete endpoint with automatic provider selection from countryCode)
Query Parameters
- Query->FirstName and Query->LastName are mandatory
- Query->DateOfBirth is optional. Date can be given both as full date (YYYY-MM-DD) or as a year only.
- Query->PersonalNumber is optional, use together with CountryCode. The NORDIC provider has all persons in PEP listed with PersonalNumber so this parameter is a recommendation for perfect PEP match rate in the Nordic countries.
- Query->CountryCode for citizenship is optional but recommended.
- (obsolete, replaced with selection on URL) DataSource (on root level) can be used to specify a data provider such as GLOBAL or NORDIC.
Note that all queries, even when using full name and dateOfBirth, can return false positives. Also note there is a degree of fuzzy match in the search, so different spelling of names should not hide hits.
NORDIC Request Example
POST https://api.zignsec.com/v2/ekyc/watchlist/nordic HTTP/1.1 Content-Type: application/json; charset=UTF-8 Authorization: YOUR_KEY... { "Query":{ "FirstName":"Daniel", "LastName":"Eriksson", "DateOfBirth": "1942-02-28", "personalnumber":"194202281111", "CountryCode":"se", } }
NORDIC Response Example
{ "id": "9735e800-28b4-4796-a33b-41617df47196", "errors": [], "HitCountTotal": 1, "HitCountPEP": 1, "HitCountSanctions": 0, "_DataSource": "DP07", "AttributeId": "attr0", "Countries": [], "Entities": [], "Individuals": [ { "Addresses": [ "SWE " ], "Aliases": [ "Daniel Eriksson" ], "AttributeId": null, "BirthDate": "1942-02-28T00:00:00", "Comment": null, "Engagements": [], "ExternalId": "1489-5", "ExternalUrls": [ "https://google.com" ], "FunctionDescription": null, "HitRating": 5, "Id": 112, "IsMale": null, "KeyWordHitRating": 1.0, "LastUpdate": "2021-10-25T13:41:23", "ListType": "PEP", "Name": "Daniel Eriksson", "OriginalBirthDate": "1942-02-28", "PostDate": null, "SourceName": "PEP_Edge", "Ssn": "SE194202281111", "Title": null, "Url": null, "Xml":"/n" } ] }
NORDIC Request Example 2, PEP hit by relation (RCA)
POST https://api.zignsec.com/v2/ekyc/watchlist/nordic HTTP/1.1 Authorization: YOUR-KEY { "Query":{ "FirstName":"david", "LastName":"batra", "DateOfBirth":"1972-11-29", "CountryCode":"se" } }
NORDIC Response Example 2 (PEP hit by relation)
Observe that the relationship to the Politically Exposed Person is expressed in the fieldTitle
“Husband of Anna Kinberg Batra, Former Member of parliament”{ "id": "e8da9dd0-ec36-4f81-87dd-fd05251faac8", "errors": [], "HitCountTotal": 1, "HitCountPEP": 1, "HitCountSanctions": 0, "_DataSource": "DP07", "AttributeId": "attr1", "Countries": [], "Entities": [], "Individuals": [ { "Addresses": [ ",,,SWE" ], "Aliases": [ "David Chandra Batra" ], "AttributeId": "attr1", "BirthDate": "1972-11-29T00:00:00", "Comment": null, "Engagements": [], "ExternalId": "SE.Relative.Ed-202041", "ExternalUrls": [ "https://sv.wikipedia.org/wiki/Anna_Kinberg_Batra", "https://sv.wikipedia.org/wiki/David_Batra" ], "FunctionDescription": null, "HitRating": 4, "Id": 117659, "IsMale": true, "KeyWordHitRating": 0.95, "LastUpdate": "2018-12-10T17:17:21.663", "ListType": "PEP", "Name": "David Chandra Batra", "OriginalBirthDate": "1972-11-29", "PostDate": null, "SourceName": "PEP_Edge", "Ssn": null, "Title": "Husband of Anna Kinberg Batra, Former Member of parliament", "Url": null, "Xml": "\n " } ], "Name": null }
NORDIC Response Field Descriptions
id | ZignSec’s guid (globally unique identifier) for the request. |
errors | A JSON object that contains information on error conditions that might have resulted from the request, in an array of property-value pairs. If multiple errors occur, a pair of parameters is returned for each error. code Code for the error. List of codes is in table below. description A string that describes the type of error that occurred. If no errors occur, then this object is empty. errors : [] |
Entities[] | An array of legal entities matching. |
Individuals[] | An array of individuals matching. See next table for structure. Each Individual hit has amongst others a HitRating field and a ListType field, describing the match. (HitRating indicates how relevant this list item is to the query. The higher number, the more accurate, with 5 being the most accurate. SSN=> 5 Full BirthDate => 4 Year part of Birthdate => 2 Name => 1.) |
HitCountTotal | The total number of positive matches under node individuals , is equal to HitCountPEP + HitCountSanctions |
HitCountPEP | The number of positive matches in PEP lists, is equal to number of rows under node individuals where listType is equal to PEP. |
HitCountSanctions | The number of positive matches in Sanctions lists, is equal to number of rows under node individuals where listType is equal to SANCTION. |
NORDIC response Field Description for Individual
Added | DateTime | Date when this entry was added. |
Addresses | Address[] | A array of Addresses as strings. |
Aliases | String[] | A array of Aliases as strings. |
SubQueryId | String | The id of the QueryAttribute that returned this instance as a match. |
BirthDate | String | The BirthDate of the Individual. Returns null if it was not set. |
BirthDateSource | String | The BirthDate of the Individual as defined in the source. Returns null if it was not set. |
Comment | String | Comment, if any. |
Engagements | An array of engagements to an entities if any is registered. | |
ExternalID | String | The ExternalID, i.e., the original id supplied by the source. |
ExternalUrls | String[] | A array of external URLs as strings. |
FunctionDescription | String | The function of the Individual. ie occupation or official position. |
HitRating | int | This is most important for separating false positives. Indicates how relevant this list hit is to the query. The higher the number, the more accurate hit, with 5 being the most accurate. SSN=> 5 Full BirthDate => 4 Year part of Birthdate => 2 Name => 1. |
Id | int | Database Id. Only for internal use as it will not be persistent through data imports. |
IsMale | bool | Returns true if the sex of the Individual is male. Returns null if it was not set. |
KeywordHitrating | decimal | Gets or sets the keyword hit rating. |
LastUpdate | DateTime | The date of the last update. |
ListType | string | String indicating the ListType. The value used is the name of the ServiceGroupConfiguration. Ex: SANCTION or PEP. |
Name | string | The name of the Item. |
PostDate | DateTime | The date supplied by the source. |
SourceName | string | String indicating the source. Ex: EU_GLOBAL. |
SSN | string | The SSN of the individual. |
Title | string | The title of the Individual. |
URL | string | URL, if any, to the source document. |
Xml | string | The data in XML format. If the source was in XML this is the original data. |
NORDIC Data Sources covered by the Nordic provider
PEP lists:
- PEP List (100% coverage on known PEP and RCA with SSN and/or date of birth in Sweden. Very good coverage on date of birth on known PEP and RCA in Norway, Denmark, Finland and Iceland.)
Sanction lists:
- United Nations Security Council Consolidated Sanctions List (UNSC)
- European Union Commission Consolidated List (EU)
- HM United Kingdom Treasury Consolidated List (UKT)
NORDIC Test persons matched in Nordic PEP SANCTION for test env.
Test persons for the NORDIC Watchlist provider for the Test environment can be found here.
Global Data Sources covered by the global provider
PEP lists:
- A consolidated global PEP list, which is growing and updated on a daily basis.
Sanction Lists:
- United Nations Sanctions (UN)
- US Consolidated Sanctions
- OFAC – Specially Designated Nationals (SDN)
- EU Financial Sanctions
- UK Financial Sanctions (HMT)
- Australian Sanctions
- Switzerland Sanction List – SECO
- INTERPOL Wanted List
- Consolidated Canadian Autonomous Sanctions List
- Office of the Superintendent of Financial Institutions (Canada)
- Bureau of Industry and Security (US)
- Department of State, AECA Debarred List (US)
- Department of State, Nonproliferation Sanctions (US)
GLOBAL Request Example
Parameter Name | Description |
Query | Is a structure of type Address, where only FirstName and LastName are necessary, but DateOfBirth and CountryCode are optional |
MatchRate | A percentage from 1-100, which indicates how closely the name being checked matches the name on the matching watchlist profile, with 1% being not close and 100% being very close. |
ListType | Can be pep or sanction. Leave as empty to scan on all lists. |
Only one of the two lists below can have a value and their value should be a comma-separated id. Eg: UN, SDN etc… Go to sanction lists | |
IncludedLists | use if you want to scan only over a specified sanction lists |
ExcludedLists | If you wish to exclude particular sanction lists from your scan |
POST https://api.zignsec.com/v2/ekyc/watchlist/global HTTP/1.1 Content-Type: application/json; charset=UTF-8 Authorization: YOUR_KEY... { "Query":{ "FirstName":"Stefan", "LastName":"Löfven", "dateofbirth":"1957-07-21", "countrycode":"se" }, "MatchRate": 85, "ListType": "...", "IncludedLists": "...", "ExcludedLists": "..." }
GLOBAL Response Example
{ "id": "0b830b26-9a93-4de7-b2df-fa3c7df814ef", "errors": [], "HitCountTotal": 3, "HitCountPEP": 3, "HitCountSanctions": 0, "_DataSource": "DP08", "Date": "2019-03-18T15:38:40.2769819+01:00", "Scan_ID": "s3199897", "Number_Of_Matches": 3, "Persons": [ { "Update_At": null, "Category": "PEP", "Name": "Stefan Löfven", "First_Name": "Stefan", "Last_Name": "Löfven", "Gender": "male", "Dates_Of_Birth": [ { "Date": "1957-07-21", "Note": null } ], "Places_Of_Birth": null, "Reference_Type": "PEP", "Nationality": "", "Places": [ { "Country": "Sweden", "Location": null, "Type": "Legislature" } ], "Other_Names": [ { "Name": "Stefan Löfven", "Type": "Sort Name" }, { "Name": "Stephanus Löfven", "Type": "" }, { "Name": "Stefan Lofven", "Type": "" }, { "Name": "ستيفان لوفن", "Type": "" }, { "Name": "Стэфан Лёвен", "Type": "" }, { "Name": "Стэфан Лёвэн", "Type": "" }, { "Name": "Стефан Льовен", "Type": "" }, { "Name": "Στέφαν Λεβέν", "Type": "" }, { "Name": "استفان لوفون", "Type": "" }, { "Name": "סטפן לוון", "Type": "" }, { "Name": "Ստեֆան Լյովեն", "Type": "" }, { "Name": "ステファン・ロベーン", "Type": "" }, { "Name": "სტეფან ლევენი", "Type": "" }, { "Name": "스테판 뢰벤", "Type": "" }, { "Name": "Stēfans Levēns", "Type": "" }, { "Name": "Стефан Лефвен", "Type": "" }, { "Name": "स्टेफान ल्योव्हेन", "Type": "" }, { "Name": "Лёвен, Стефан", "Type": "" }, { "Name": "இசுடீவன் இலோவென்", "Type": "" }, { "Name": "สเตฟัน เลอเวน", "Type": "" }, { "Name": "Стефан Лөвен", "Type": "" }, { "Name": "استیفن لووین", "Type": "" }, { "Name": "斯蒂凡·洛夫文", "Type": "" } ], "Roles": [ { "Title": "Member of Riksdag (Socialdemokraterna)", "Category": null, "Since": "2014-09-29", "To": "2014-10-02", "Type": "" } ], "Occupations": null, "Children": null, "Siblings": null, "Images": [ "http://data.riksdagen.se/filarkiv/bilder/ledamot/ac737989-5fa0-44bc-ad69-c1a0ddba71bb_max.jpg", "https://upload.wikimedia.org/wikipedia/commons/e/e1/Stefan_Löfven_efter_slutdebatten_i_SVT_2014_(cropped).jpg" ], "Contacts": null, "Links": [ { "URL": "https://en.wikipedia.org/wiki/Stefan_Löfven", "Type": "Wikipedia (en)" }, { "URL": "https://commons.wikimedia.org/wiki/Category:Stefan_Löfven", "Type": "Wikimedia Commons" }, { "URL": "https://nl.wikinews.org/wiki/Categorie:Stefan_Löfven", "Type": "Wikinews (nl)" }, { "URL": "https://cs.wikiquote.org/wiki/Stefan_Löfven", "Type": "Wikiquote (cs)" }, { "URL": "https://fa.wikiquote.org/wiki/استفان_لوفون", "Type": "Wikiquote (fa)" }, { "URL": "https://pl.wikiquote.org/wiki/Stefan_Löfven", "Type": "Wikiquote (pl)" }, { "URL": "https://sv.wikiquote.org/wiki/Stefan_Löfven", "Type": "Wikiquote (sv)" }, { "URL": "https://facebook.com/stefanlofven", "Type": "facebook" } ], "Political_Parties": null, "Father": null, "Mother": null, "Spouse": null, "Summary": null, "Match_Rate": 100.0 }, { "Update_At": "2019-02-26", "Category": "PEP", "Name": "Stefan Löfven", "First_Name": "Stefan", "Last_Name": "Löfven", "Gender": "male", "Dates_Of_Birth": [ { "Date": "1957-07-21", "Note": null } ], "Places_Of_Birth": [ { "Location": "Aspudden", "Country": "Sweden" } ], "Reference_Type": "PEP", "Nationality": "", "Places": [ { "Country": "Sweden", "Location": "Sager House", "Type": "residence" }, { "Country": null, "Location": "Stockholm", "Type": "work location" } ], "Other_Names": [ { "Name": "Kjell Stefan Löfven", "Type": "Also Known As" }, { "Name": "Stefan Löfvén", "Type": "Also Known As" }, { "Name": "Kjell Stefan Löfven", "Type": "" }, { "Name": "Stefan Löfven", "Type": "" } ], "Roles": [ { "Title": "Prime Minister of Sweden", "Category": null, "Since": "2014-10-03", "To": "", "Type": null }, { "Title": "chairperson", "Category": null, "Since": "2006", "To": "2012-01-27", "Type": null }, { "Title": "member of the Riksdag", "Category": null, "Since": "2014-09-29", "To": "", "Type": null }, { "Title": "Leader of the Opposition", "Category": null, "Since": "2012-01-27", "To": "2014", "Type": null }, { "Title": "party leader", "Category": null, "Since": "2012-01-27", "To": "", "Type": null } ], "Occupations": [ "politician", "welder", "trade unionist" ], "Children": null, "Siblings": null, "Images": [ "http://commons.wikimedia.org/wiki/Special:FilePath/Stefan%20L%C3%B6fven%20efter%20slutdebatten%20i%20SVT%202014%20%28cropped%29.jpg" ], "Contacts": [ { "Value": "stefanlofven", "Type": "Facebook profile ID" } ], "Links": null, "Political_Parties": [ { "Title": "Swedish Social Democratic Party", "Since": "", "To": "" } ], "Father": null, "Mother": null, "Spouse": "Ulla Löfvén", "Summary": "", "Match_Rate": 100.0 }, { "Update_At": "28 Jan 2019", "Category": "PEP", "Name": "Stefan LOFVEN", "First_Name": null, "Last_Name": null, "Gender": null, "Dates_Of_Birth": null, "Places_Of_Birth": null, "Reference_Type": "PEP", "Nationality": "", "Places": [ { "Country": "Sweden", "Location": null, "Type": null } ], "Other_Names": null, "Roles": [ { "Title": "Prime Minister, Ministry (Sweden)", "Category": null, "Since": null, "To": null, "Type": null } ], "Occupations": null, "Children": null, "Siblings": null, "Images": null, "Contacts": null, "Links": null, "Political_Parties": null, "Father": null, "Mother": null, "Spouse": null, "Summary": null, "Match_Rate": 100.0 } ] }
GLOBALPREMIUM Request Example
{ "Query": { "FirstName":"Thomas", "LastName":"Oppermann", "CountryCode":"de" }, "MatchRate": 80, "ListType": "pep", "IncludedLists": "", "ExcludedLists": "" }
GLOBALPREMIUM Response Example
{ "id": "026f2739-33d2-4859-bec9-c4213aa2e2e2", "errors": [], "Date": "2020-02-18T01:33:04.0232028+11:00", "ScanId": "s5200509", "NumberOfMatches": 1, "Persons": [ { "Id": null, "Category": "PEP", "MatchRate": 100, "ResultId": null, "Flag": null, "Person": { "UniqueId": null, "Categories": "Politically Exposed Person (PEP)", "Subcategory": null, "Gender": "Male", "Deceased": "NO", "PrimaryFirstName": "Thomas", "PrimaryMiddleName": "Ludwig Albert", "PrimaryLastName": "Oppermann", "Title": "Mr", "Image": "https://secure.c6-intelligence.com/c6images/0020555000/0020554581.jpg", "Position": null, "DateOfBirth": "27 Apr 1954", "DeceasedDate": null, "PlaceOfBirth": "", "PrimaryLocation": "Germany", "GeneralInfo": { "Nationality": "German", "AlternateTitle": null, "BusinessDescription": null, "Website": null }, "FurtherInformation": "PEP Tier 1\r\n", "EnterDate": null, "LastReviewed": null, "Descriptions": [ { "Description1": "Politically Exposed Person (PEP)", "Description2": "", "Description3": "" } ], "NameDetails": [ { "NameType": "Also Known As", "FirstName": "Thomas", "MiddleName": null, "LastName": "Opperman" } ], "OriginalScriptNames": [], "Roles": [ { "Title": "Vice-President of the Bundestag (Lower Chamber of the Federal Parliament)", "From": "2017", "To": "Present", "Type": null, "Status": null, "Country": "Germany" }, { "Title": "Member of the Bundestag (Lower Chamber of the Federal Parliament) for Constituency Goettingen", "From": "2005", "To": "Present", "Type": null, "Status": null, "Country": "Germany" }, { "Title": "Former Minister of Science and Culture of the State of Lower Saxony", "From": "1998", "To": "2003", "Type": null, "Status": null, "Country": "Germany" }, { "Title": "Former Member of the State Parliament (Landtag) of Lower Saxony", "From": "1990", "To": "2005", "Type": null, "Status": null, "Country": "Germany" }, { "Title": "Chairperson of the Social Democratic Party of Germany (Sozialdemokratische Partei Deutschlands, SPD) for Goettingen Branch", "From": "1989", "To": null, "Type": null, "Status": null, "Country": "Germany" }, { "Title": "Former Judge at the Administrative Court (Verwaltungsgericht)", "From": "1986", "To": "1990", "Type": null, "Status": null, "Country": "Germany" }, { "Title": "Member of the Social Democratic Party of Germany (Sozialdemokratische Partei Deutschlands, SPD)", "From": "1980", "To": " ", "Type": null, "Status": null, "Country": "Germany" }, { "Title": "Former Member of the Advisory Board of the Energie Baden-Wurttmemberg AG (State-Owned Enterprise)", "From": null, "To": null, "Type": null, "Status": null, "Country": "Germany" } ], "ImportantDates": [ { "DateType": "Date of Birth", "DateValue": "27 Apr 1954" } ], "Locations": [ { "Country": "Germany", "City": "Berlin", "Address": "Deutscher Bundestag, Platz der Republik 1 11011" }, { "Country": "Germany", "City": "Freckenhorst", "Address": "Warendorf" } ], "Countries": [], "OfficialLists": [], "IdNumbers": [], "LinkedIndividuals": [], "LinkedCompanies": [ { "Name": "Energie Baden-Wurttmemberg AG", "Categories": "SIE", "Subcategories": null, "Description": "Former Member of the Advisory Board" } ], "Sources": [ { "Url": "https://www.focus.de/politik/deutschland/politik-dieser-junge-wollte-minister-werden_id_3552081.html", "Categories": "ID/V", "Dates": "2019-05-08" }, { "Url": "https://www.thomasoppermann.de/lebenslauf/", "Categories": "PEP", "Dates": "2019-05-08" }, { "Url": "https://www.enbw.com/media/downloadcenter-konzern/jahresabschluss-der-enbw-ag/jahresabschluss-der-enbw-ag-2006.pdf", "Categories": "Corporate/Business, PEP", "Dates": "2019-05-08" }, { "Url": "https://www.bundestag.de/abgeordnete/biografien/O/oppermann_thomas/522472", "Categories": "ID/V, PEP", "Dates": "2018-08-20" }, { "Url": "https://www.bundestag.de/abgeordnete/biografien#", "Categories": "PEP", "Dates": "2017-10-02" }, { "Url": "http://www.ruhr-uni-bochum.de/bsz/514/zitate.html", "Categories": "PEP", "Dates": "2016-08-08" }, { "Url": "http://www.bundestag.de/bundestag/abgeordnete18/biografien/O/oppermann_thomas/258820", "Categories": "ID/V, PEP", "Dates": "2014-07-14" }, { "Url": "http://www.bundestag.de/bundestag/abgeordnete18/alphabet/index.html", "Categories": "PEP", "Dates": "2013-09-26" }, { "Url": "http://www.bundestag.de/bundestag/abgeordnete17/alphabet/index.html", "Categories": "PEP", "Dates": "2013-04-30" }, { "Url": "http://www.abgeordnetenwatch.de/abgeordnete-337-0-2.html#profile", "Categories": "ID/V, PEP", "Dates": "2011-08-25" }, { "Url": "http://www.bundestag.de/bundestag/abgeordnete17/biografien/O/oppermann_thomas.html", "Categories": "ID/V, PEP", "Dates": "2009-10-13" } ] } } ], "_DataSource": "DP08" }
GLOBAL Sanction Lists
ID | Name |
UN | United Nations Sanctions (UN) |
NSDN | US Consolidated Sanctions |
SDN | OFAC – Specially Designated Nationals (SDN) |
EU | EU Financial Sanctions |
UK | UK Financial Sanctions (HMT) |
AU | Australian Sanctions |
SECO | Switzerland Sanction List – SECO |
INT | INTERPOL Wanted List |
SEMA | Consolidated Canadian Autonomous Sanctions List |
OSFI | Office of the Superintendent of Financial Institutions (Canada) |
BIS | Bureau of Industry and Security (US) |
AECA | Department of State, AECA Debarred List (US) |
PROLIF | Department of State, Nonproliferation Sanctions (US) |
OTHER | Other Lists |
Data Provider Selection:
The watchlist service has three data providers:- The Global provider [GLOBAL/DP08] is general, and gives a detailed explanation for every positive hit.
- The Nordic provider [NORDIC/DP07] is only for the four Nordic countries Sweden, Denmark, Finland, Norway, and manually pruned and up to date.
- (The older Global provider [DP04] still reachable by setting Datasource=DP04.)
Parameter condition in priority order | Resulting Watchlist provider |
---|---|
No datasource and No country code given | GLOBAL |
datasource=GLOBAL or datasource=DP08 | GLOBAL |
datasource=NORDIC or datasource=DP07 | NORDIC |
datasource=DP04 | older GLOBAL provider |
countryCode=se/fi/dk/no | NORDIC |
countryCode=other than se/fi/dk/no | GLOBAL |