Understanding Monitoring Events Types

Monitoring in sanctions.io delivers real-time status updates and event tracking for your monitoring entries, accessible via the Monitoring Portal (dashboard) or the Monitoring API.

This guide introduces the three key event types you’ll encounter when using the monitoring webhook or polling endpoints:

Creation of a monitoring entry
Match detection against a sanctions list and watchlist
Completion of the monitoring process

Monitoring Entry Created

When a new entry is added to monitoring (either via the API or the dashboard), you’ll receive a webhook payload containing an object of type monitoring_entry.

This event indicates that the monitoring process has begun, and initial screening is currently in progress.

New Match Found

When a potential match is detected, a monitoring_result object is created. This includes key fields such as confidence_score, status, timestamp, and the associated data_entry (e.g., name, aliases, citizenship). These details help you evaluate and manage the match effectively.

You can later tag the result as a False Positive or Real Positive using the update endpoint.

Monitoring Entry Processed

The PROCESSED state indicates that all screening and match evaluations have been completed for the monitoring entry.

After reviewing a match, you can confirm the outcome by tagging it as a False Positive or Real Positive using the update endpoint. You can also add explanatory notes as part of the update.

Make the Most of Key Monitoring Events

Use external_identifier to link entries with internal records: This enables clear traceability and simplifies case management across your systems.
Track entry lifecycle via status fields: Monitor transitions from PROCESSING to PROCESSED to ensure entries are fully ingested and screened.
Leverage real-time webhooks: Receive instant alerts when a new match is detected, enabling prompt review and action.