Follow a Watchlists Ongoing Monitoring status

Watchlists Ongoing Monitoring is webhook-driven. Rather than polling, you subscribe to the events below and react to them in your application. For details on setting up and managing webhooks, see the dedicated Webhooks section.

Lifecycle events — one webhook per status change:

Event	Sent when
`monitoring.natural_person.activated`	The subscription has been confirmed and is now live.
`monitoring.natural_person.inconclusive`	The subscription could not be set up. See `status_codes`.
`monitoring.natural_person.canceled`	The monitoring has been stopped, either because you canceled it or because Youtrust did. When the Ongoing Monitoring add-on is removed from the organization, all its active monitorings are canceled and one webhook is sent per monitoring: make sure your integration handles this case.

Change event:

Event	Sent when
`monitoring.natural_person.updated`	The monitored natural person has changed (e.g. a new PEP position, an updated sanctions status or a change on one of the companies they are involved in).

All lifecycle payloads (activated, inconclusive, canceled) share the same envelope as the updated event: event_id, event_name, event_time, subscription_id, subscription_description, sandbox, and data.natural_person.

Example — monitoring.natural_person.activated

{
  "event_id": "d09f0367-d80a-309c-a2ed-7083991fc564",
  "event_name": "monitoring.natural_person.activated",
  "event_time": "1670855889",
  "subscription_id": "d09f0367-d80a-309c-a2ed-7083991fc564",
  "subscription_description": "Notifies our system when an event occurs.",
  "sandbox": false,
  "data": {
    "natural_person": {
      "id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
      "workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
      "created_at": "2025-02-12T23:59:59+00:00",
      "updated_at": "2025-02-12T23:59:59+00:00",
      "status": "active",
      "status_codes": [],
      "first_name": "Emmanuel",
      "last_name": "Macron",
      "born_on": "1977-12-21"
    }
  }
}

Example — monitoring.natural_person.updated

{
"event_id": "d09f0367-d80a-309c-a2ed-7083991fc564",
"event_name": "monitoring.natural_person.updated",
"event_time": "1670855889",
"subscription_id": "d09f0367-d80a-309c-a2ed-7083991fc564",
"subscription_description": "Notifies our system when an even occurs.",
"sandbox": true,
"data": {
"natural_person": {
"id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
"workspace_id": "08739e2d-35cf-4889-a323-bb103f068529",
"created_at": "2026-07-30T10:00:00+00:00",
"updated_at": "2026-07-30T10:00:02+00:00",
"status": "active",
"status_codes": [],
"first_name": "Emmanuel",
"last_name": "Macron",
"born_on": "1977-12-21"
},
"updates": {
"new_sanctions": [
{
"started_on": "2026-07-01",
"authority": "EU",
"description": "Asset freeze",
"country_code": "FR"
}
],
"new_political_positions": [
{
"started_on": "2026-07-02",
"title": "Ministre",
"country_code": "FR"
}
],
"companies": [
{
"company_information": {
"number": "987654321",
"name": "NEWCO"
},
"new_mandates": [
{
"type": "natural_person",
"first_name": "Jean",
"last_name": "Dupont",
"born_on": "1980-01",
"company_name": "HOLDCO",
"company_number": "552100554",
"titles": [
"Président"
],
"started_on": "2026-07-03"
}
],
"removed_mandates": [
{
"type": "natural_person",
"first_name": "Marie",
"last_name": "Martin",
"born_on": "1975-06",
"company_name": "HOLDCO",
"company_number": "552100554",
"ended_on": "2026-07-04"
}
],
"updated_titles": [
{
"type": "natural_person",
"first_name": "Jean",
"last_name": "Dupont",
"born_on": "1980-01",
"company_name": "HOLDCO",
"company_number": "552100554",
"new_titles": [
"Directeur général",
"Président"
],
"old_titles": [
"Président"
],
"updated_on": "2026-07-05"
}
],
"new_notices": [
{
"notice": "Jugement d'ouverture de liquidation judiciaire",
"bodacc": "A",
"notice_number": "42",
"publication_number": "20260130",
"type": "Procédure collective",
"proceeding_type": "Liquidation judiciaire",
"started_on": "2026-07-06"
}
]
}
]
}
}
}

Status codes

Code	Meaning
`NPM_1100`	The provider returned an error while setting up the subscription.
`NPM_1000`	The organization is no longer subscribed to the Ongoing Monitoring add-on, so the monitoring was not started.