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
, and click .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 |
*Required object | See the following sample requests for sample values. | Object containing information about the event. |
*Required string | One of:
| The type of event. |
Optional object | See the following sample request for a PEP match for a sample value. | Object containing additional information about PEP matches. |
Optional Boolean |
| Whether the match is current. If this string is not sent, the match will not display the "PEP" flag in the portal. |
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. |
Optional Boolean |
| Whether the match is current. If this field is not sent, the match will not display the "Sanctions" flag in the portal. |
Optional string |
While there are additional values for | 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 |
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.