PEP and Sanctions 006 Service

PEP and Sanctions 006 service

PEP and Sanctions 006 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, or under sanction. If there are multiple matches, it provides a list of them, up to a limit of 100.

Properties

The following properties pertain to this service.

Property Name Type Optional/Mandatory Notes
NameQuery
String
Mandatory The name of the person you are searching for.
NameQueryMatchThreshold
Integer
Optional The minimum name match score to match against. Default is 80 (all matches).
DateOfBirthMatchThreshold
Integer
Optional 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.
DayOfBirth
Integer
Optional Used with DateOfBirthMatchThreshold.
MonthOfBirth
Integer
Optional Used with DateOfBirthMatchThreshold.
YearOfBirth
Integer
Optional Used with DateOfBirthMatchThreshold.

Response

<W2DataPepAndSanction006Result>
	 <!-- One or more of these --> 
	 <MatchResults>
		<CheckMatch>
		   <BirthDay />
		   <BirthMonth />
		   <BirthYear />
		   <DateOfBirthMatchScore />
		   <MatchType>Person</MatchType>
		   <Name>Al Zoubi, Muhammad Hussein</Name>
		   <NameMatchScore>85</NameMatchScore>
		   <ProfileId>WC8042</ProfileId>
		</CheckMatch>
	 </MatchResults>
</W2DataPepAndSanction006Result>

The following table gives some more details about the response.

Property Name Type Description
BirthDay
Integer
The birth day of the record matched against.
BirthMonth
Integer
The birth month of the record matched against.
BirthYear
Integer
 The birth month of the record matched against.
DateOfBirthMatchScore
Integer
The score that this record's date of birth matched the query date.
MatchType
MatchTypeEnum
The type of match where the data is available in the source. See below
Name
String
The name of the record matched against. Depending on the source data there may be multiple names here combined into one.
NameMatchScore
Integer
The score that this record's name matched the query name.
ProfileId
String
A unique reference for a profile that can be subsequently retrieved in full using the ProfileDetails Service.

Transaction Result

HaltTriggered False
ServiceTransactionResult
  • Success
  • SuccessIncompleteResults Too many matches on the search criteria and the results have been truncated
  • ServerErrorGeneralError An error occurred
  • ClientErrorInsufficientInformation Required field not supplied - NameQuery or Forename / Surname
ServiceInterpretResult
  • OneResult
  • MultipleResults
  • NoResults
  • NotPerformed - An error occurred and the search was not performed
ServiceTransactionResultMessage Usually empty, can contain optional information such as too many matches etc.
ValidationResult
  • NotApplicable - No search occurred to match against
  • Fail MissingMandatoryField or PatternNotMatched
  • Pass


Notes

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.

More information about the match type

Enumeration Value  Value  Description 
Person 1 The match is a Person.
Entity 2 The match is an Entity.
Unknown 3 The match is of unknown type. This may represent missing data and does not necessarily mean 'other'.
Vessel 4 The match is a vessel (usually maritime).
Aircraft 5 The match is an aircraft.

Sandbox

In sandbox the name "Ahenobarbus Michal" will return one result and the name "Allen Kiril" will return three results. These names are used by our alpha service as well.

In addition, there are a few entries for the name "Robert Mugabe". These can be searched in the same way as live, with correct scores for name and DOB threshold. So searches for the terms such as "Rob", "Robert", "Mug", "Mugabe" will return results.