ZignSec

WatchList PEP+Sanctions

WatchList is our due diligence service to check if a given person is listed on a PEP (Politically Exposed Person) or Sanctions list. PEP can be defined as “in a prominent public position or a close relative of someone who is.” The coverage is broad with general PEP and Government Sanction lists, Anti-terrorism Lists, CIA lists and custom lists.

We have two providers for the service: NORDIC and GLOBAL.

You can select provider manually by setting a DataSource parameter, on the same level as Query parameter, to either NORDIC, GLOBAL, a provider id (DPnn) or set to AUTO / left out (recommended) in which case you will have an automatic data provider selected based on the countryCode parameter, see example calls below.

  • AUTO or “left out” (recommended) – Provider selected automatically based on the value of countrycode.
  • NORDIC – Specialized for the nordic countries, Sweden, Norway, Finland and Denmark. This list is manually pruned which gives higher quality and it also has lots of details.
  • GLOBAL – Has a wider list coverage, but lacks details and classify hits as either Good (quite certain) or Questionable (less certain). .

Test persons for the NORDIC Wathlist provider for the Test environment can be found here.

Note that queries, even when given with both full name and dateofbirth, can result in false positives back.

API

POST to https://env.zignsec.com/v2/ekyc/watchlist
where env is api or test.

Parameters

  • Query->FirstName and Query->LastName are mandatory
  • Query->DateOfBirth is optional, but without it hits will be catgorized as Questionable. 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.
  • There is a degree of fuzzy match in the search, so different spelling of names should not hide hits.
  • Root level DataSource can optionally be used to select which provider to use, Nordic, Global, Auto or finally by DPnn name.

Example Request -> countrycode se -> Nordic provider automatically selected

            POST https://api.zignsec.com/v2/ekyc/watchlist 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"
   }
}
        

Example Response 1 – countryCode set -> automatic selection of NORDIC provider:
Personal number is hidden in this example.

            {
  "id": "00bddf62-2988-4945-8d76-635dd706b98e",
  "errors": [],
  "HitCountTotal": 1,
  "_DataSource": "DP07",
  "AttributeId": "attr1",
  "Countries": [],
  "Entities": [],
  "Individuals": [
    {
      "Addresses": [
        "SWE"
      ],
      "Aliases": [
        "Kjell Stefan 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": 1,
      "Id": 21481,
      "IsMale": true,
      "KeyWordHitRating": 1.0,
      "LastUpdate": "2018-07-08T16:06:47.09",
      "ListType": "PEP",
      "Name": null,
      "OriginalBirthDate": "1957-07-21",
      "PostDate": null,
      "SourceName": "PEP_Edge",
      "Ssn": "SE19570721----",
      "Title": "Prime Minister",
      "Url": null,
      "Xml": null
    }
  ],
  "Name": null
}
        

NORDIC provider – 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
HitCountTotal The total number of good/correct hits in INDIVIDUALS, always is HitCountPEP + HitCountSanctions
HitCountPEP The total number of good/correct PEP list hits, is the number of hit Individuals with listType set to PEP.
HitCountSanctions The total number of good/correct Sanctions list hits, is the number of hit Individuals with listType set to SANCTION.

NORDIC: Field description for item 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 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.
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.

Example Request 2 – (no countryCode set -> automatic selection of GLOBAL provider)

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

            POST https://api.zignsec.com/v2/ekyc/watchlist HTTP/1.1
Content-Type: application/json; charset=UTF-8
Authorization: YOUR_KEY...

{
   "Query":{
      "FirstName":"Stefan",
      "LastName":"Löfven", 
      "dateofbirth":"1957-07-21"
   }
}

        

Example Response – Global provider
The id and DataProviderRequestId fields are for support situations with ZignSec and the back-end data provider.

The HitCountTotal is the field to look at to get the overall hit count.

            {
  "id": "f505bf74-beaa-43fd-8ed1-2d3268b15582",
  "errors": [],
  "HitCountTotal": 3,
  "HitCountPEP": 3,
  "HitCountSanctions": 0,
  "PEPHits": [
    "A match was made during a PEP check   //   PROP",
    "A match was made during a CIA World Leader List check   //   CIA_WORLDLEADER",
    "A match was made during a List of all National Legislature members check   //   NTL_LEGISLATOR"
  ],
  "SanctionsHits": [],
  "QuestionableHitCountTotal": 0,
  "QuestionableHitCountPEP": 0,
  "QuestionableHitCountSanctions": 0,
  "QuestionablePEPHits": [],
  "QuestionableSanctionsHits": [],
  "DataProviderRequestId": "WS-7848986.2018.7.10.2.49.15.917"
}
        

GLOBAL provider – 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 : []
HitCountTotal The total number of good/correct hits, always is HitCountPEP + HitCountSanctions
HitCountPEP The total number of good/correct PEP list hits, is the number of rows in the PEPHits[] field.
HitCountSanctions The total number of good/correct Sanctions list hits, is the number of rows in the SanctionsHits[] field.
PEPHits A description list of good/correct PEP-list hits.
SanctionsHits A description list of good/correct Sanctions-list hits.
QuestionableHitCountTotal The total number of hits that are less certain, always is QuestionableHitCountPEP + QuestionableHitCountSanctions
QuestionableHitCountPEP The total number of PEP list hits that are less certain, is the number of rows in the QuestionablePEPHits[] field.
QuestionableHitCountSanctions The total number of Sanctions list hits that are less certain, is the number of rows in the QuestionableSanctionsHits[] field.
QuestionablePEPHits A list of PEP-list hit descriptions that are less certain.
QuestionableSanctionsHits A list of Sanctions-list hit descriptions that are less certain.
DataProviderRequestID An internal identifier for tracking the request with our support.

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)

Data Sources covered by the Global provider

PEP lists:

  • PEP List (1.1 Million Individuals, spanning 233 countries)
  • Canadian Office of the Superintendent of Financial Institutions Individual List
  • CIA World Leader List
  • National Legislature Members List

Sanction lists:

  • United Nations Security Council Consolidated Sanctions List (UNSC)
  • US Office of Foreign Assets Control – Treasury Department
  • European Union Commission Consolidated List (EU)
  • HM United Kingdom Treasury Consolidated List (UKT)
  • Canadian Office of the Superintendent of Financial Institutions Entities List