Skip to content
On this page


About the service

PEPDesk service checks if a specified person is a politically exposed person, i.e. they are in a prominent public position or a close relative of someone who is. If there are multiple matches, it provides a list of them, up to a limit of 100.

Product Code: W2-DATA-PEP-003

Does this service leave a credit search Footprint? No


The following properties pertain to this service.

Property NameTypeOptional/MandatoryNotes
NameQueryString🔒The name of the person you are searching for. Default field used for matching, can be blank if Forename/MiddleNames/Surname used instead.
NameQueryMatchThresholdInteger-The minimum name match score to match against. Default is 80 (all matches)
DateOfBirthMatchThresholdInteger-The minimum date of birth score to match against. Default is null (off). If supplied, at least one component of the date of birth must be supplied.
DayOfBirthInteger-Used with DateOfBirthMatchThreshold.
MonthOfBirthInteger-Used with DateOfBirthMatchThreshold.
YearOfBirthInteger-Used with DateOfBirthMatchThreshold.


Example response

  "PEPDeskCheckResult": {
    "MatchResults": [
         "birthDay": 8,
         "birthMonth": 1,
         "birthYear": 1983,
         "matchType": "Person",
         "name": "Kim, Jong Un",
         "nameMatchScore": 100,
         "profileId": "839ecc35-3ebc-e340-b4cb-f298ce520995"

Response breakdown

Property NameTypeDescription
BirthDayStringThe birth day of the record matched against.
BirthMonthIntegerThe birth month of the record matched against.
BirthYearIntegerThe birth month of the record matched against.
DateOfBirthMatchScoreIntegerThe score that this record's date of birth matched the query date.
MatchTypeMatchTypeEnumThe type of match where the data is available in the source. See below
NameStringThe name of the record matched against. Depending on the source data there may be multiple names here combined into one.
NameMatchScoreIntegerThe score that this record's name matched the query name.
ProfileIdStringA unique reference for a profile that can be subsequently retrieved in full using the Profile Details Service.

The date of birth parameters will be null if no date of birth matching threshold was specified, even if the record has a date of birth, as it reflects the matching that occurred.

Represents the type of match.

Enumeration ValueValueDescription
Person1The match is a Person.
Entity2The match is an Entity.
Unknown3The match is of unknown type. This may represent missing data and does not necessarily mean 'other'.
Vessel4The match is a vessel (usually maritime).
Aircraft5The match is an aircraft.

Transaction Result

HaltTriggered | FalseServiceTransactionResult| Success
SuccessIncompleteResults - Too many matches generated, results truncated
ClientErrorInsufficientInformation - Required field not supplied
ClientErrorInformationFormatInvalid - Invalid format in field
ServerErrorGeneralError - Error with third party serviceServiceInterpretResult | OneResult
NotPerformed - An error occurred and the search was not performedServiceTransactionResultMessage | Usually empty, can contain optional information such as too many matches etc. ValidationResult | NotApplicable - No search occurred to match against
Fail - MissingMandatoryField or PatternNotMatched

Search Filters

Available Filters

Applying Filters:

    "Options": {
        "Sandbox": "false",
        "IncludeCountries":"GBR,UDF,SUP - Up to 20 comma delimited countries",
        "ExcludeExPeps": "true | false",
        "IncludeExPEPsFromDate": "1990-08-17 OR 1990-08-17T06:04:18Z - UTC Date Time"
Filter TypeDescription
Include CountriesIf included, this filter will only return alerts that are on profiles that indicate that the main country of residence/activity is in the included country. Please note that if this filter is used, we advise to also use the 2 additional filters for undefined and supra-Nationals. This will include alerts generated for subjects that cannot be readily assigned to a country.
Exclude Ex-PEPIf included, this filter excludes alerts that would have been generated on individuals that have left the office that attracted their 'PEP status' for a defined period of time. For a risk based approach, it is normally appropriate to consider ex-PEPs for some time, however, this time will differ based on the risk profile of the business that your organisation conducts.
IncludeExPEPsFromDateIf included, this filter includes alerts that are generated on individuals who gained their ex-PEP status after the specified date.


Example Request - PEP Desk

    "Bundle": "KYC_PEP",
    "Data": {
        "NameQuery": "David Cameron"
    "Options": {
        "Sandbox": "true"
    "ClientReference": "your-client-reference"

Example Response for "David Cameron":

	"HaltTriggered": "False",
	"ServiceInterpretResult": "Multiple Results",
	"ServiceTransactionResult": "Success",
	"ServiceTransactionResultMessage": "This call was generated using sandbox mode",
	"ValidationResult": "Pass"

Example Response for all OTHER name queries:

	"HaltTriggered": "False",
	"ServiceInterpretResult": "NoResults",
	"ServiceTransactionResult": "SuccessNoResults",
	"ServiceTransactionResultMessage": "This call was generated using sandbox mode",
	"ValidationResult": "Pass"