Cancel a Watchlists Ongoing Monitoring

On this page, you will learn how to stop a monitoring using the API.

Use this endpoint when you no longer want to be notified about an entity. Youtrust unsubscribes on its side, sets the monitoring to canceled and sends a monitoring.natural_person.canceled webhook.

Only an active monitoring can be canceled. Cancelling a pending, inconclusive or already canceled monitoring returns a 400 Bad Request with the error type natural_person_monitoring.status_not_compatible. A pending monitoring must first become active before it can be canceled.

POST /monitorings/natural_persons/{id}/cancel

Response payload

{
  "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-03-04T10:12:31+00:00",
  "status": "canceled",
  "status_codes": [],
  "first_name": "Emmanuel",
  "last_name": "Macron",
  "born_on": "1977-12-21"
}
ℹ️

canceled is a final status. A monitoring cannot be restarted — create a new one to resume monitoring the same entity.