Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

Version 1 Next »

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 accountId must be supplied with every call to any method in this API.

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 verficationId that has been previously registered, via the registerVerification web method, with greenID.  If the verficationId cannot be found in the greenID database, then an InvalidTokenException will be thrown.

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 – the password 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

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 yyyy-MM-dd'T'HH:mm:ss.SSSZ.

registrationDetails

RegistrationDetails

Details that were supplied for registration.

RegistrationDetails

name

Data Structures V5

The person's name.

dob

Data Structures V5

The person's date of birth.

currentResidentialAddress

Data Structures V5

The person's current residential address.

previousResidentialAddress

Data Structures V5

The person's previous residential address.

email

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

PersonMatchSummary

Match summary of the profile

listofAlternativeNames

ListofAlternativeNames

Lists Also Known As

listOfDateOfBirth

ListOfDateOfBirth

List of DOB

listOfDateOfDeath

ListOfDateOfDeath

List of Date of Death

listOfPlaceOfBirth

ListOfPlaceOfBirth

List of Place of Birth

listOfAssociates

ListOfAssociates

List of associates details 

listOfDetailedCheckedResults

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

ListOfMatchDataItems

Name

Type

Description

matchDataItems

List<MatchDataItem>

MatchDataItem

Name

Type

Description

name

String

value

String

  • No labels