This method allows customers to retrieve a detailed watchlist result when they’re configured with Comprehensive Watchlist screening.
Web Service Endpoints
Test: https://test-au.vixverify.com/Registrations-Registrations/WatchlistServiceV1?wsdl
Production: https://au.vixverify.com/Registrations-Registrations/WatchlistServiceV1?wsdl
Input Parameters
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 | Must be numeric Max page size is 100 |
pageNumber | String | No | Must be a numeric value. |
Exceptions
InvalidCustomerIdException
– the accountId input parameter was missing or not recognised.InvalidCertificateException
– if certificates are used to connect, then this exception may be thrown if an invalid certificate is used.InvalidPasswordException
– thepassword
input parameter was missing or incorrect.InvalidFieldException
– one of the required fields was missing, or the format of a field was not valid. For example, this may be thrown if an email address is not valid.InvalidSourceIPAddressException
- if web service IP restriction is enabled, then this exception will be thrown if the caller's IP address is not white-listed.SystemException
- an unexpected error occurred.InvalidPageNumber - the value is not numeric or does not exist.
InvalidPageSize - the value is not numeric or greater than 100.
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 | Verification details | |
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 |
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 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 | ||
homePhone | String | |
mobilePhone | String | |
workPhone | String |
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 Also Known As | |
listOfDateOfBirth | List of DOB | |
listOfDateOfDeath | List of Date of Death | |
listOfPlaceOfBirth | List of Place of Birth | |
listOfAssociates | List of associates 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 knows as |
ListOfDateOfBirth
Name | Type | Description |
---|---|---|
dob | List<String> | List of dates of births associated with the person |
ListOfDateOfDeath
Name | Type | Description |
---|---|---|
dateOfDeath | List<String> |
ListOfPlaceOfBirth
Name | Type | Description |
---|---|---|
placeOfBirth | List<String> |
ListOfPlaceOfBirth
Name | Type | Description |
---|---|---|
placeOfBirth | List<String> |
ListOfAssociates
Name | Type | Description |
---|---|---|
Associate | List<Associate> | Associates details |
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 | |
listingEndDate | String | |
watchlistCategory | String | |
watchlistUrl | String | |
watchlistName | String | |
watchlistDescription | String | |
pepClass | String | |
listOfMatchDataItems |
ListOfMatchDataItems
Name | Type | Description |
---|---|---|
matchDataItems | List<MatchDataItem> |
MatchDataItem
Name | Type | Description |
---|---|---|
name | String | |
value | String |