ZignSec

WatchList PEP+Sanctions

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": "<OriginalData>\n<Item><OriginalData /></Item></OriginalData>"
	}],
	"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": "<OriginalData>\n<Item><OriginalData /></Item></OriginalData>"
    }
  ],
  "Name": null
}
        

NORDIC Response Field Descriptions

id Zignsec’s guid (globally unique identifier) for the request.
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.)
HitCountTotal The total number of positive matches under node individuals, is equal to HitCountPEP + HitCountSanctions
HitCountPEP The number of postitive matches in PEP lists, is equal to number of rows under node individuals where listType is equal to PEP.
HitCountSanctions The 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

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 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

(the Query item is a structure of type Address, where only FirstName and LastName are necessary, but DateOfBirth and CountryCode are optional):

            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"
   }
}

        

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
    }
  ]
}
        

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