Watchlists Ongoing Monitoring
On this page, you will learn how to continuously monitor a natural person through the API, and be notified whenever their situation changes.
Unlike a one-time verification screening, Watchlists Ongoing Monitoring is a subscription service. You subscribe to a natural person once, and Youtrust notifies you over time — via webhooks — whenever a relevant change is detected, such as a natural person taking on a new politically exposed position.
How it works
The process is straightforward and consists of the following steps:
- Subscribe a natural person via the API. The monitoring is created with the
pendingstatus. - Receive a confirmation. Once the subscription is active, the status moves to
activeand you receive themonitoring.natural_person.activatedwebhook. - Receive updates via the
monitoring.natural_person.updatedwebhook each time the monitored entity changes. - Cancel the monitoring whenever you no longer need it.
What is monitored
Natural persons — changes to sanctions status, Politically Exposed Person (PEP) exposure, and the companies the person is involved in (new and removed mandates, updated titles, new legal notices such as a collective proceeding published in the BODACC).
Coming soon — Legal personsMonitoring of legal persons (companies) is coming soon for France. Stay tuned.
Statuses
| Status | Description |
|---|---|
pending | The subscription has been received and is being set up. No notifications are sent yet. |
active | The subscription is live. You will receive monitoring.natural_person.updated webhooks when the entity changes. |
inconclusive | The subscription could not be set up. See status_codes (NPM_1100 or NPM_1000). This is a final status — create a new monitoring to try again. |
canceled | The monitoring has been stopped and no further notifications will be sent. This is a final status — create a new monitoring to resume. |
Updated 1 day ago