- Created by Sharmeen Hussain , last modified by Adrian Loo on Dec 18, 2024
You are viewing an old version of this content. View the current version.
Compare with Current View Version History
« Previous Version 14 Current »
This method allows customers to retrieve a detailed watchlist result when they’re configured with Comprehensive Watchlist screening (via Comply Advantage).
Web Service Endpoints
Test: https://test-au.vixverify.com/Registrations-Registrations/WatchlistServiceV1?wsdl
Production: https://au.vixverify.com/Registrations-Registrations/WatchlistServiceV1?wsdl
Only use this method on verification IDs that have a match on watchlist(s) result, otherwise an error response will be thrown.
Input Parameters
This method supports pagination. Please ensure that all results are retrieved by using the pagination parameters when using this method.
Name | Type | Required | Restrictions |
---|---|---|---|
accountId | String | Yes | GreenID issues each customer with an accountId, which is a unique identifier by which greenID knows the caller. This |
password | String | Yes | Each customer is issued a password that must be supplied with every call to any web method in this API. |
verificationId | String | Yes | This parameter must be a valid |
pageSize | String | No | Default is 25. Must be a positive integer. Max page size is 100. |
pageNumber | String | No | Must be a positive integer. |
Faults & Exceptions
Type | FaultCode | Detail |
---|---|---|
accountId is missing | FieldValidationFault | accountID is missing |
verificationId is missing | FieldValidationFault | verificationid is missing |
verificationId is not found | VerificationIdNotFoundFault | <verificationId supplied in the request> |
Invalid password or invalid accountId | InvalidPasswordFault | <password or accountId supplied in the request> |
Invalid page size | FieldValidationFault | Invalid page size |
Invalid page number | FieldValidationFault | Invalid page number |
Page number does not exist | FieldValidationFault | An unexpected problem occurred. Invalid page number. |
Invalid certificates (when certificates are used) | InvalidCertificateFault | <accountId supplied in the request> |
Invalid Source IP Address | InvalidIPAddressFault | IP address |
System exception | SytemFault | Details will vary based on exception type. |
Return Value
This method returns WatchlistCheckDetails object. The following members will be populated:
Verification – this field contains the results of checks that have been performed to date, and the person’s current verification status.
ProfileMatch – this field will contain a list of individual person profile matches returned from a watchlist provider
WatchlistCheckDetails
Name | Type | Description |
---|---|---|
verification | Details of the verification these watchlist results relate to. | |
dateChecked | String | Date timestamp the watchlist check performed. |
lastActionDate | String | Date time stamp the watchlist check was last actioned. |
watchlistProduct | String | Name of the watchlist product |
overallWatchlistStatus | String | Overall watchlist status. Will be one of:
|
customerIdentifier | String | The ‘case’ identifier from the watchlist provider. |
numberOfProfileMatches | int | Total number of person profiles matched. |
watchlistCheckDetailsCurrentPage | int | Current page number - Use default if no value provided in the input. |
watchlistCheckDetailsPageTotal | int | Total number of pages. |
watchlistCheckDetailsPageSize | int | Current page size - use default if no value provided in the input. |
profileMatch | List<ProfileMatch > | Details of individual person profile(s) matched. |
Verification
Name | Type | Description |
---|---|---|
verificationId | String | The unique identifier for this verification attempt. |
dateCreated | String | The timestamp of when this verification attempt was created. The string will be formatted in the ISO 8601 format. The pattern used to generate this string in Java is |
registrationDetails | Details that were supplied for registration. |
RegistrationDetails
name | The person's name. | |
dob | The person's date of birth. | |
currentResidentialAddress | The person's current residential address. | |
previousResidentialAddress | The person's previous residential address. | |
String | The person’s email address, if provided. | |
homePhone | String | The person’s home phone number, if provided. |
mobilePhone | String | The person’s mobile phone number, if provided, |
workPhone | String | The person’s work phone number, if provided. |
ProfileMatch
Name | Type | Description |
---|---|---|
personName | String | Name of the person matched. |
personMatchType | String | Person matched type. |
personWatchlistsStatus | String | Watchlist status of the profile. |
personMatchSummary | Match summary of the profile. | |
listofAlternativeNames | Lists of Also Known As. | |
listOfDateOfBirth | List of known DOBs. | |
listOfDateOfDeath | List of known Date of Death. | |
listOfPlaceOfBirth | List of known Place of Birth. | |
listOfAssociates | List of known associate details. | |
listOfDetailedCheckedResults | List of detailed check results. |
PersonMatchSummary
Name | Type | Description |
---|---|---|
associatesCount | int | Count of associates matched. Zero (0) if no match. |
sanctionsCount | int | Count of sanctions matched. Zero (0) if no match. |
warningsAndOtherListsCounts | int | Count of warnings and lists matched. Zero (0) if no match. |
PEPCount | int | Count of pep matched. Zero (0) if no match. |
adverseMediaCount | int | Count of media matched. Zero (0) if no match. |
ListOfAlternateNames
Name | Type | Description |
---|---|---|
name | List<String> | Also Known As (an alias the person is known by). |
ListOfDateOfBirth
Name | Type | Description |
---|---|---|
dob | List<String> | List of known dates of birth. |
ListOfDateOfDeath
Name | Type | Description |
---|---|---|
dateOfDeath | List<String> | List of known dates of death. |
ListOfPlaceOfBirth
Name | Type | Description |
---|---|---|
placeOfBirth | List<String> | List of known places of birth. |
ListOfAssociates
Name | Type | Description |
---|---|---|
Associate | List<Associate> | List of known Associates. |
Associate
Name | Type | Description |
---|---|---|
name | String | Associate name. |
type | String | Associate type. |
ListOfDetailedCheckResults
Name | Type | Description |
---|---|---|
detailedCheckResult | List<DetailedCheckResult> | List of Detailed watchlist results. |
DetailedCheckResult
Name | Type | Description |
---|---|---|
listingStartDate | String | Date the source was first published. |
listingEndDate | String | Date the source was removed. |
watchlistCategory | String | The type of watchlist match. Will be one of:
|
watchlistUrl | String | URL of the source. |
watchlistName | String | Name of the source. |
watchlistDescription | String | A description of the source. |
pepClass | String | The classification of the source, will be one of:
|
listOfMatchDataItems | A list of fields associated with the match. This list contains the specific details of this match. |
ListOfMatchDataItems
Name | Type | Description |
---|---|---|
matchDataItems | List<MatchDataItem> | A list of name-value pairs, each of which contains a specific detail related to this match. |
MatchDataItem
Name | Type | Description |
---|---|---|
name | String | The name of the field. |
value | String | The name of the field. |
- No labels