/v1/sessions/{id}/watchlist-screening

Get
/v1/sessions/{id}/watchlist-screening

Returns a list of data objects from PEP and Sanctions services associated with a specific session Id = {id}

Only available for customers using the Veriff PEP and Sanctions services.

For matchTypes, see the data provider's documentation [↗] for more detailed info.


Note: always ensure that you use the correct API URL to send requests. See the API URL section for more info.



Security
API Key
Header parameter namex-auth-client

Your integration's API key (occasionally referred to the "Token", "API public key" or "Publishable key")

Header parameters
x-hmac-signature
stringRequired

Session id signed with the shared secret key

Path parameters
id
stringRequired

Session id

Responses
200

Watchlist screening data

Expand All
object
status
string

API request status

data
object

Data containing PEP & Sanctions result details

attemptId
string (uuid)

UUID v4 which identifies session attempt

Exampleaea9ba6d-1b47-47fc-a4fc-f72b6d3584a7
sessionId
string (uuid)

UUID v4 which identifies session

Examplef04bdb47-d3be-4b28-b028-a652feb060b5
vendorData
string

The unique identifier that you created for your end-user. It can be max 1,000 characters long and contain only non-semantic data that can not be resolved or used outside your systems or environments. Veriff returns it unmodified in webhooks and API response payloads, or as null if not provided

Example1234567890
checkType
string

Indicates if the response is for the initial check or a subsequent check, one of initial_result or updated_result

Exampleinitial_result
matchStatus
string

Indicates if there was a match in the database, one of possible_match, no_match

Examplepossible_match
searchTerm
object

Data used to perform the check

name
string

Full name used during the check

ExampleGADDAFI
year
string

Birth year used during the check

Example1942
totalHits
number (integer)

Total number of hits returned from the check

Example1
createdAt
string (Combined ISO 8601 date and time in UTC, YYYY-MM-DDTHH:MM:SS.SSS+Timezone Offset|Z)

Timestamp indicating when the check response was received

Example2021-07-05T13:23:59.851Z
hits
Array of object (PepSanctionMatchHit)

Array of records that were matched. Empty array if no hits were found

object
matchedName
string

The name that was matched in this hit based on the search term

ExampleMouammar Mohammed Abu Minyar Kadhafi
countries
Array of string

List of countries that sources listed in relation to this hit

Example[ "Australia, Brazil" ]
string
dateOfBirth
string

Birth date of the person in the matched listings

Example1942
dateOfDeath
string

Death date of the person in the matched listings

Example2011
matchTypes
Array of string

Array that shows the match type in the listings

Example[ "matching_name" ]
string
aka
Array of string

Array of names that the matched person is also known as

Example[ "Moamarr Qaddafi" ]
string
associates
Array of string

Array of names that the matched person is associated with

Example[]
string
listingsRelatedToMatch
object

Matched listings. Empty object if addon "PEP & Sanctions check" is not enabled

warnings
Array of object (RelatedListing)

Array of objects

object
sourceName
string

Source name of the related listing

ExampleComplyAdvantage PEP data
sourceUrl
string

Source URL of the related listing

date
string | null

Date of the related listing

sanctions
Array of object (RelatedListing)

Array of objects

object
sourceName
string

Source name of the related listing

ExampleComplyAdvantage PEP data
sourceUrl
string

Source URL of the related listing

date
string | null

Date of the related listing

fitnessProbity
Array of object (RelatedListing)

Array of objects

object
sourceName
string

Source name of the related listing

ExampleComplyAdvantage PEP data
sourceUrl
string

Source URL of the related listing

date
string | null

Date of the related listing

pep
Array of object (RelatedListing)

Array of objects

object
sourceName
string

Source name of the related listing

ExampleComplyAdvantage PEP data
sourceUrl
string

Source URL of the related listing

date
string | null

Date of the related listing

adverseMedia
Array of object (RelatedListing)

Array of objects

object
sourceName
string

Source name of the related listing

ExampleComplyAdvantage PEP data
sourceUrl
string

Source URL of the related listing

date
string | null

Date of the related listing

202

Watchlist screening is in progress

object
status
string

API request status

tracking
string

Tracking URL

400

Bad request

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleValidation failed
401

Unauthorized

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleMandatory X-AUTH-CLIENT header containing the API key is missing from the request.
402

Watchlist screening is not enabled

404

Session not found

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleResource not found
500

Internal server error

object
status
string
Valid values[ "fail" ]
Examplefail
code
string
Example1101
message
string
ExampleSomething went wrong