Test ongoing monitoring using the API

Some data providers offer ongoing monitoring for PEPs, sanctions, and adverse media checks.

With ongoing monitoring, after the check has been run the first time, the profile is monitored for any new matches. If they're discovered, they're displayed on the task.

To find out if you're using ongoing monitoring, first check the configuration information for your data provider to see if monitored screening checks can be used and whether it's enabled by default. If a configuration option needs to be enabled, use the Policy Builder to see if the configuration option is in use on your account.

To see what happens when new ongoing monitoring results are returned, follow these steps in your demo environment:

Create a profile.
Run the check from the portal or from the API.
If there are any matches, resolve them. The fastest way to do this is to go to the task in the portal, click the checkbox next to Name, and click Ignore.
Pass the task. Note that your configuration may pass the task automatically when no matches are returned or when all matches are resolved.
Make a request to the following endpoint, or use the cURL command provided, to create a new unresolved event, or match, on the profile. If the task becomes incomplete and the new match is displayed in the results, the test is working as expected.

Request endpoint:

POST https://api.passfort.com/4.0/profiles/{profile_id}/events

Body parameters:

Key	Value	Description
`data` *Required object	See the following sample requests for sample values.	Object containing information about the event.
`data.event_type` *Required string	One of: `PEP_FLAG` `SANCTION_FLAG` `ADVERSE_MEDIA_FLAG` `REFER_FLAG`	The type of event.
`data.pep` Optional object	See the following sample request for a PEP match for a sample value.	Object containing additional information about PEP matches.
`data.pep.match` Optional Boolean	`true` or `false`	Whether the match is current. If this string is not sent, the match will not display the "PEP" flag in the portal.
`data.sanctions` Optional array of objects	See the following sample request for a sanctions match for a sample value.	Array of objects containing additional information about sanctions matches.
`data.sanctions.is_current` Optional Boolean	`true` or `false`	Whether the match is current. If this field is not sent, the match will not display the "Sanctions" flag in the portal.
`resolution` Optional string	`UNRESOLVED` While there are additional values for `resolution`, you should send `UNRESOLVED` for the purposes of this test.	Whether the match is a true match, a false positive, or a match that has not been resolved as either. If no value is sent, the `resolution` will be `UNRESOLVED`.

Learn more about the Create a new profile event endpoint, including additional values you can pass in the request, in the Passfort API reference.

Sample request for a PEP match

Sample request body:

{
    "resolution": "UNRESOLVED",
    "data": {
        "event_type": "PEP_FLAG",
        "match_name": "Blake Carr",
        "pep": {
             "match": true
        }
    }
}

Sample cURL command:

curl --location --request POST 'https://api.passfort.com/4.0/profiles/6e39cbec-d338-11ea-85bc-c20bbea0206f/events' \
--header 'apikey: adc5788e3b7fecc161d2a36916750ee10480a8c75841bd' \
--header 'Content-Type: application/json' \
--data-raw '{
    "resolution": "UNRESOLVED",
    "data": {
        "event_type": "PEP_FLAG",
        "match_name": "Blake Carr",
        "pep": {
            "match": true
        }
    }
}'

Sample request for a sanctions match

Sample request body:

{
   "resolution": "UNRESOLVED",
   "data": {
       "event_type": "SANCTION_FLAG",
       "match_name": "Blake Carr",
       "sanctions": [
           {
               "is_current": true
           }
       ]
   }
}

Sample cURL command:

curl --location --request POST 'https://api.passfort.com/4.0/profiles/6e39cbec-d338-11ea-85bc-c20bbea0206f/events' \
--header 'apikey: adc5788e3b7fecc161d2a36916750ee10480a8c75841bd' \
--header 'Content-Type: application/json' \
--data-raw '{
    "resolution": "UNRESOLVED",
    "data": {
        "event_type": "SANCTION_FLAG",
        "match_name": "Blake Carr",
        "sanctions": [
            {
                "is_current": true
            }
        ]
    }
}'

Replace the sample API key with your own when using the cURL commands.

Additional information

In this section:

Test ongoing monitoring using the API

Sample request for a PEP match

Sample request for a sanctions match

Additional information

Search results