PEPs
The PEPs datasource is a data source containing information about Politically Exposed Persons (PEPs). PEPs are individuals who currently hold or have held significant public or political positions in governments, international organizations, state-owned enterprises, or political parties. These data sources are used in due diligence and compliance processes, especially in financial and business sectors, to identify and mitigate risks of money laundering, corruption, and terrorism financing. Information contained in PEPs datasources includes individuals' names, their political positions or roles, as well as any relevant associations that may pose a potential risk to an organization.
This service classifies each PEP at a certain level, which indicates the severity of the exposure.
pep-class-1: Heads of State Members of the national executive Members of national legislatures Senior military and law enforcement officials High-ranking officials of national agencies Members of central bank boards Senior officials of the judiciary (national level) High-ranking officials of high-level political parties.
pep-class-2: Members of the Boards of International Organizations (IOs) and International Sports Federations Ambassadors, high commissioners, and other high-level diplomatic positions Members of the regional executive Members of regional legislatures Senior officials in the regional judiciary.
pep-class-3: Senior managers and board members of state-owned companies and organizations.
pep-class-4: Mayors and local government officials (sub-regional level).
Section: kycPepsLatamCountries or kycPepsEmergingCountries
Each PEPs query can have two sections for each category, one Latam and one Emerging Countries. These categories are defined based on the country where you (CAF Client) are legally based.
Latam: We use the term "Latam," but it may not necessarily be from Latin America; we have included other countries in the list, but we continue to use the same service name, check the list below with the names of all countries included.
South Africa, Angola, Algeria, Benin, Botswana, Burkina Faso, Burundi, Cape Verde, Chad, Comoros, Democratic Republic of the Congo, Republic of the Congo, Ivory Coast, Djibouti, Egypt, Eritrea, Ethiopia, Gabon, Gambia, Ghana, Guinea, Equatorial Guinea, Lesotho, Liberia, Libya, Madagascar, Malawi, Mali, Morocco, Mauritius, Mauritania, Mayotte, Mozambique, Namibia, Niger, Nigeria, Kenya, Cameroon, Reunion, Rwanda, Western Sahara, Saint Helena, Sao Tome and Principe, Senegal, Sierra Leone, Seychelles, Somalia, Eswatini, Sudan, South Sudan, Tanzania, Togo, Tunisia, Uganda, Zambia, Zimbabwe, Central African Republic, and Guinea-Bissau.
Section for customers who belong to the “Latam” group of countries:
- kycPepsLatamCountries
Emerging countries: We use the term "Emerging countries," but it may not necessarily consist only of Emerging Countries; we have included other countries in the list, but we continue to use the same service name.
Anguilla, Antigua and Barbuda, Aruba, Bahamas, Barbados, Belize, Bermuda, Canada, Costa Rica, Cuba, Curaçao, Dominica, El Salvador, United States, Grenada, Greenland, Guadeloupe, Guatemala, Haiti, Honduras, Cayman Islands, United States Distant Islands, Turks and Caicos Islands, British Virgin Islands, U.S. Virgin Islands, Jamaica, Martinique, Mexico, Montserrat, Nicaragua, Caribbean Netherlands, Panama, Puerto Rico, Dominican Republic, Saint Pierre and Miquelon, Saint Lucia, Saint Barthélemy, Saint Kitts and Nevis, Saint Martin, Saint Vincent and the Grenadines, Saint Martin, Trinidad and Tobago, Argentina, Bolivia, Brazil, Chile, Colombia, Ecuador, Guyana, French Guiana, Falkland Islands, Paraguay, Peru, Suriname, Uruguay, Venezuela, Antarctica, South Georgia and the South Sandwich Islands, Bouvet Island, Heard Island and McDonald Islands, French Southern and Antarctic Lands, Afghanistan, Saudi Arabia, Armenia, Azerbaijan, Bahrain, Bangladesh, Brunei, Bhutan, Cambodia, Qatar, Kazakhstan, China, Singapore, North Korea, South Korea, United Arab Emirates, Philippines, Georgia, Hong Kong, Yemen, Christmas Island, India, Indonesia, Iran, Iraq, Israel, Japan, Jordan, Kuwait, Laos, Lebanon, Macau, Malaysia, Maldives, Myanmar (Burma), Mongolia, Nepal, Oman, Pakistan, Kyrgyzstan, Syria, Sri Lanka, Thailand, Taiwan, Tajikistan, British Indian Ocean Territory, Palestinian Territories, Turkmenistan, Uzbekistan, Vietnam, East Timor, Russia, Turkey, Bosnia and Herzegovina, Albania, Germany, Andorra, Austria, Belgium, Belarus, Bulgaria, Cyprus, Holy See, Croatia, Denmark, Slovakia, Slovenia, Spain, Estonia, Finland, France, Gibraltar, Greece, Guernsey, Netherlands, Hungary, Isle of Man, Åland Islands, Faroe Islands, Ireland, Iceland, Italy, Jersey, Latvia, Liechtenstein, Lithuania, Luxembourg, North Macedonia, Malta, Moldova, Monaco, Montenegro, Norway, Poland, Portugal, United Kingdom, Czech Republic, Romania, San Marino, Serbia, Sweden, Switzerland, Svalbard and Jan Mayen, Ukraine, Kosovo, Australia, Fiji, Guam, Norfolk Island, Cocos (Keeling) Islands, Cook Islands, Northern Mariana Islands, Marshall Islands, Pitcairn Islands, Solomon Islands, Micronesia, Nauru, Niue, New Caledonia, New Zealand, Palau, French Polynesia, Kiribati, Samoa, American Samoa, Tokelau, Tonga, Tuvalu, Vanuatu, Wallis and Futuna, Papua New Guinea.
Section for customers who belong to the “Emerging Countries” group of countries:
- kycPepsEmergingCountries
name
string
Full name of the individual.
Yes
birthDate
string
Date of birth of the individual.
Yes
countryCode
string
Country code of the individual.
Yes
Note: Some fields returned by this API are optional and their presence cannot be guaranteed.
data
object
Object containing the main data.
data.riskLevel
string
Risk level associated with the entity.
data.clientRef
string
Client reference related to the hit.
data.blacklistHits
array
List of hits found in blacklist searches.
data.hits
array
List of matches found.
data.hits[].doc
object
Object containing information associated with the hit.
data.hits[].doc.types
array
List of types of information related to the hit.
data.hits[].doc.associates
array
List of associates found.
data.hits[].doc.associates[].name
string
Name of the associated entity.
data.hits[].doc.associates[].association
string
Type of association with the entity (spouse, brother, etc.).
data.hits[].doc.sources
array
List of information sources, which can be state or private organizations and positions.
data.hits[].doc.keywords
array
List of keywords related to the hit.
data.hits[].doc.sourceNotes
object
Additional notes from sources related to the hit.
data.hits[].doc.sourceNotes
object
This object contains each type of source reported in “sources” with the respective information for each organization or position.
data.hits[].doc.sourceNotes.$type
object
This type need to be replaced by any source of information or position (usCiaWorldLeaders, complyadvantage, eurasianEconomicUnionLeadership, russianPresident, etc.).
data.hits[].doc.sourceNotes.$type.name
string
Name of the organization or position.
data.hits[].doc.sourceNotes.$type.amlTypes
array
Types of related information of entity. This list contains the pep classes for each information (pep-class-1, pep-class-2, etc.).
data.hits[].doc.sourceNotes.$type.countryCodes
array
Countries related to information.
data.hits[].doc.sourceNotes.$type.url
string
Link to the source of information.
data.hits[].doc.entityType
string
Type of entity (person, company, etc.).
data.hits[].doc.media
array
List of media related to the hit. (news, websites, etc.).
data.hits[].doc.birthDate
array
List of possible birth dates related to the hit.
data.hits[].doc.createdAt
string
Timestamp indicating when the hit was created.
data.hits[].doc.countryCodes
array
Related countries of hit.
data.hits[].doc.assets
array
List of files related to the entity.
data.hits[].doc.assets[].publicUrl
string
Public link of file.
data.hits[].doc.assets[].source
string
Source of information.
data.hits[].doc.assets[].type
string
Type of file (picture, etc.).
data.hits[].doc.assets[].url
string
File link.
data.hits[].doc.aka
array
List of all aka related to the entity.
data.hits[].doc.aka[].name
string
Aka name.
data.hits[].doc.name
string
Entity name of hit.
data.hits[].doc.deathDate
string
List of death dates related to the entity.
data.hits[].doc.id
string
Unique identifier of the main record.
data.hits[].doc.fields
object
This field contains all detailed information about each type of information related to the hit.
data.hits[].doc.fields.$type
object
This type needs to be replaced by a category, which will be named "pepClass" or "other".
data.hits[].doc.fields.$type.$information
array
This information needs to be replaced with any name that references the origin of this information (usCiaWorldLeaders, complyadvantage, eurasianEconomicUnionLeadership, russianPresident, etc.).
data.hits[].doc.fields.$type.$information[].name
string
Indicates the type of information (Country, date of birth, other info, etc.).
data.hits[].doc.fields.$type.$information[].value
string
Field where the value of the information is, which can be text, link, date of birth, etc.
data.hits[].doc.fields.$type.$information[].tag
string
Internal tag with tabulated values for the category of each information (date_of_birth, related_url, country_names, etc.).
data.hits[].score
number
Indicates the hit score value.
data.hits[].matchStatus
string
Indicates the hit status (potential_match, true_positive, etc.).
data.hits[].isWhiteListed
boolean
Indicates if the hit is in a white list.
data.hits[].matchTypes
array
List of match types for each hit. (aka_exact, year_of_birth, etc.).
data.hits[].matchTypesDetails
array
Details of name matches, sources, and secondary matches for each entity. In this field, all hit information is analyzed individually, to classify them according to their relevance.
data.hits[].matchTypesDetails[].nameMatches
array
Information about each entity, including query terms and match types.
data.hits[].matchTypesDetails[].nameMatches[].matchTypes
array
Classification of matches for the respective information (exact_match, partial_match, etc.).
data.hits[].matchTypesDetails[].nameMatches[].queryTerm
string
The specific query term used for the match. (name, date, etc.).
data.hits[].matchTypesDetails[].amlTypes
array
Type of classification associated with each match (pep-class-1, pep-class-2, etc.).
data.hits[].matchTypesDetails[].sources
array
Sources of hit information.
data.hits[].matchTypesDetails[].secondaryMatches
array
Additional matches related to each individual information.
data.hits[].matchTypesDetails[].secondaryMatches[].matchTypes
array
Classification of secondary matches for the respective information (exact_match, partial_match, etc.).
data.hits[].matchTypesDetails[].secondaryMatches[].queryTerm
string
The specific query term used for the secondary match. (name, date, etc.).
data.hits[].matchTypesDetails[].matchingName
string
The full name of each matched individual (Ex: Nicolás Maduro Moros).
data.createdAt
string
Timestamp indicating when the record was created.
data.ref
string
Reference identifier associated with the record.
data.matchStatus
string
Final status of the query (no_match, false_positive, potential_match, true_positive, unknown, true_positive_approve, true_positive_reject).
data.totalHits
number
Total number of hits associated with the record.
data.cached
boolean
Indicates whether the record is cached.
data.totalBlacklistHits
number
Total number of hits in the blacklist associated with the record.
data.shareUrl
string
URL for sharing the record.
data.id
number
Unique identifier of the record.
data.totalMatches
number
Total number of matches associated with the record.
data.updatedAt
string
Timestamp indicating when the record was updated.
statusCode
string
Last updated