PEP and Sanctions

PEP and Sanctions and Adverse Media Check

Content of this Guide

Overview

The PEP Sanctions Endpoints allow searching for a business or individual on thousands of Sanctions, Politically Exposed Persons and Adverse Media lists. A PEP Sanction Check on the KYC API will contain all the retrieved results on those lists and can be retrieved either in structured (JSON) format or as a PDF after a successful order.

The KYC API’s PEP and Sanctions service is provided by the Moody’s Analytics Global Regulatory Information Database (GRID) as a primary source. GRID contains over 13 million profiles built on tens of millions of records, continuously updated risk data archive on known or suspected corrupt private-and public-sector figures, fraudsters, illicit financiers, money launderers, organised crime figures and groups, terrorist figures, politically exposed persons, and dozens of other risk relevant categories of persons and organisations. Approximately 7,000-12,000 quality-reviewed, structured records are updated or added to GRID each day. New risk information sources are continuously incorporated into the database.

The service offers checks as below
  • Watch Lists & Sanctions: Included in the nucleus of KYC’s holdings is a comprehensive archive of regulatory authority, disciplinary actions, denied entities lists, law enforcement actions, and other government or professional oversight organisation actions taken against persons or organisations around the world. Collectively, this body of data comprises GRID records that are created and risk-event coded from public web sources that are either systemically scraped or manually aggregated from global government regulators or law enforcement authorities.
  • Politically Exposed Persons (PEPs): Different jurisdictions, regulatory bodies, and enforcement entities have varying definitions and interpretations of PEPs. The service uses the definition from the Financial Action Task Force on Money Laundering (FATF), Section 312 of the US Patriot Act, The EU AML Directives, and the Wolfsberg Principles. In other words a person who “may be” acting, is now acting, or has recently acted in the political arena of a country. An individual who is or has been entrusted with a prominent public function. In GRID, PEPs are classified into 17 categories.
  • Global Adverse Media: This provides you with a list of negative media based on a proprietary process that searches data matches of thousands of adverse key word strings. The data extract is behavioural and not collected based only on a companies or a person’s name.

Endpoints

KYC API solution is currently implemented in form of the two following endpoints

The PEP order endpoint

This POST Request will place an order for a PEP Sanction Check. The URL parameter type can be either B for Business or P for Person. The other URL parameter search should include the search string for which you are requesting the check.
When requesting a check for a person one can expand or restrict the searching process with the following (optional) POST parameters.

Parameter name Description
GivenName First name of the person
MiddleName Middle name of the person
FamilyName Last name of the person
DOB DOB: Date of birth in format (YYYY-MM-DD)
CountryCode The ISO code of the country of provenance of the information
Sex Gender of the person, in format F/M
Address Address of the person
Age Age of the person

Request
curl --location --request POST 'https://api.kompany.com/api/v1/pepsanction/order/B/360kompany' \
--header 'accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'user_key:{secret}' \
--data-urlencode 'GivenName=null' \
--data-urlencode 'MiddleName=null' \
--data-urlencode 'FamilyName=null' \
--data-urlencode 'DOB=null' \
--data-urlencode 'CountryCode=AT' \
--data-urlencode 'Sex=null' \
--data-urlencode 'Address=null' \
--data-urlencode 'Age=null'

Response
{
    "identity": "{orderId}",
    "owner": "1409622366710",
    "sku": "PEPBSRDXX",
    "price": 6,
    "subjectValue": "360kompany",
    "subjectId": "19949_1653921652753",
    "option": "24065",
    "status": "ok",
    "ordered": "1653921653",
    "request_id": "{requestId}",
    "message": "Processed ok"
}

The PEP retrieval endpoint

This GET request will return your previously ordered PEP Sanction Check identified by the product orderIdyou received in your order request.
You can request your check either in structured format (JSON) or as a PDF report, the format will depend on the ACCEPT header you include in the request.

Request
curl --location --request GET 'https://api.kompany.com/api/v1/pepsanction/retrieve/{orderId}' \
--header 'Accept: application/json' \
--header 'user_key: {secret}'

Response
{
    "search": "360kompany",
    "optional_parameters": {
        "CountryCode": "AT"
    },
    "type": "business",
    "matches": 0,
    "timestamp": "2022-05-30 14:40:53 UTC",
    "results": []
}
Please note that within this retrieval endpoint it is possible to get the structured JSON response as well as a PDF document. For reaching the PDF, simply use application/pdf in the request header. If you do not specify an ACCEPT header; the JSON will be returned.