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/global2 (uses alternative global provider) POST to https://env.zignsec.com/v2/ekyc/watchlist (obsolete endpoint with automatic provider selection from countrycode) where env is api or test.

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":"Stefan",
      "LastName":"Löfven",
      "dateOfBirth":"1957-07-21",
      "CountryCode":"SE"
   }
}

# NORDIC Response Example

{
	"id": "1b85bc77-db97-4ad1-8650-235427946e7e",
	"errors": [],
	"HitCountTotal": 1,
	"HitCountPEP": 1,
	"HitCountSanctions": 0,
	"_DataSource": "DP07",
	"AttributeId": "attr1",
	"Countries": [],
	"Entities": [],
	"Individuals": [
	{
		"Addresses": [",,,SWE"],
		"Aliases": ["Kjell Stefan Löfven Löfvén"],
		"AttributeId": "attr1",
		"BirthDate": "1957-07-21T00:00:00",
		"Comment": null,
		"Engagements": [],
		"ExternalId": "SE.Government-356",
		"ExternalUrls": ["http://www.government.se/government-of-sweden/prime-ministers-office/stefan-lofven/",
                        "https://sv.wikipedia.org/wiki/Stefan_L%C3%B6fven"],
		"FunctionDescription": null,
		"HitRating": 4,
		"Id": 117571,
		"IsMale": true,
		"KeyWordHitRating": 0.92,
		"LastUpdate": "2018-12-10T17:17:21.663",
		"ListType": "PEP",
		"Name": null,
		"OriginalBirthDate": "1957-07-21",
		"PostDate": null,
		"SourceName": "PEP_Edge",
		"Ssn": null,
		"Title": "Prime Minister",
		"Url": null,
		"Xml": "\n"
	}],
	"Name": null
}

# 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 field Title “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

idZignsec’s guid (globally unique identifier) for the request.
errorsA 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.
Indiviuals[]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.)
HitCountTotalThe total number of positive matches under node individuals, is equal to HitCountPEP + HitCountSanctions
HitCountPEPThe number of postitive matches in PEP lists, is equal to number of rows under node individuals where listType is equal to PEP.
HitCountSanctionsThe number of postitive 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

AddedDateTimeDate when this entry was added.
AddressesAddress[]A array of Addresses as strings.
Aliasesstring[]A array of Aliases as strings.
SubQueryIdstringThe id of the QueryAttribute that returned this instance as a match.
BirthDatestringThe BirthDate of the Individual. Returns null if it was not set.
BirthDateSourcestringThe BirthDate of the Individual as defined in the source. Returns null if it was not set.
CommentstringComment, if any.
Engagements An array of engagements to an entities if any is registered.
ExternalIdstringThe ExternalId, i.e the original id supplied by the source.
ExternalUrlsstring[]A array of external URLs as strings.
FunctionDescriptionstringThe function of the Individual. ie occupation or official position.
HitRatingintThis 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.
IdintDatabase Id. Only for internal use as it will not be persistent through data imports.
IsMaleboolReturns true if the sex of the Individual is male. Returns null if it was not set.
KeywordHitratingdecimalGets or sets the keyword hit rating.
LastUpdateDateTimeThe date of the last update.
ListTypestringString indicating the ListType. The value used is the name of the ServiceGroupConfiguration. Ex: SANCTION or PEP.
NamestringThe name of the Item.
PostDateDateTimeThe date supplied by the source.
SourceNamestringString indicating the source. Ex: EU_GLOBAL.
SsnstringThe Ssn of the individual.
TitlestringThe title of the Individual.
UrlstringURL, if any, to the source document.
XmlstringThe 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 Wathlist 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 NameDescription
QueryIs a structure of type Address, where only FirstName and LastName are necessary, but DateOfBirth and CountryCode are optional
MatchRateA 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.
ListTypeCan 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
IncludedListsuse if you want to scan only over a specified sanction lists
ExcludedListsIf 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
    }
  ]
}

# GLOBAL Sanction Lists

IDName
UNUnited Nations Sanctions (UN)
NSDNUS Consolidated Sanctions
SDNOFAC – Specially Designated Nationals (SDN)
EUEU Financial Sanctions
UKUK Financial Sanctions (HMT)
AUAustralian Sanctions
SECOSwitzerland Sanction List – SECO
INTINTERPOL Wanted List
SEMAConsolidated Canadian Autonomous Sanctions List
OSFIOffice of the Superintendent of Financial Institutions (Canada)
BISBureau of Industry and Security (US)
AECADepartment of State, AECA Debarred List (US)
PROLIFDepartment of State, Nonproliferation Sanctions (US)
OTHEROther 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 orderResulting Watchlist provider
No datasource and No country code givenGLOBAL
datasource=GLOBAL or
datasource=DP08
GLOBAL
datasource=NORDIC or
datasource=DP07
NORDIC
datasource=DP04older GLOBAL provider
countryCode=se/fi/dk/noNORDIC
countryCode=other than se/fi/dk/noGLOBAL