Watchlist Screening Webhook Events
Last updated March 24th, 2026
Overview
Mono Watchlist Screening sends webhook notifications to your configured endpoint when screening events occur. This enables you to react to completed screenings, monitoring changes, and failed attempts in real time.
Prerequisites
Before you begin receiving webhooks, you must:
- Configure a POST webhook endpoint on your server.
- Add the webhook URL in the Mono dashboard for your app.
- Return a
2xxresponse after successfully processing each event.
Security
Validate every webhook request with your webhook secret before processing the payload. See the Webhook Setup Guide for the recommended verification flow.
Webhook Event Types
| Event | Description |
mono.events.watchlist.screening_created | Screening request was created |
mono.events.watchlist.match_found | A risk match was identified during screening |
mono.events.watchlist.match_not_found | No risk matches found during screening |
mono.events.watchlist.match_updated | Risk status changed for a monitored subject |
mono.events.watchlist.monitoring_created | Monitoring was successfully created |
mono.events.watchlist.monitoring_completed | Monitoring was stopped or completed |
mono.events.watchlist.attempt_failed | An error occurred while processing the screening |
mono.events.watchlist.attempt_completed | Screening attempt completed |
Screening Created
Sent when a new screening request is created.
Request
123456789101112131415161718
{
"event": "mono.events.watchlist.screening_created",
"data": {
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"profile": {
"type": "individual",
"name": "Chukwuma Adamu",
"date_of_birth": "1941-08-17",
"bvn": "22123412341",
"gender": "male",
"address": "12 Admiralty Way, Lekki",
"country": "ng"
}
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}
Match Found
Sent when a risk match is identified during screening.
Request
1234567891011121314151617181920
{
"event": "mono.events.watchlist.match_found",
"data": {
"match_found": true,
"action": "Make a call to the screening result endpoint for more details",
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"profile": {
"type": "individual",
"name": "Chukwuma Adamu",
"date_of_birth": "1941-08-17",
"bvn": "22123412341",
"gender": "male",
"address": "12 Admiralty Way, Lekki",
"country": "ng"
}
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}
Match Not Found
Sent when no risk matches are found during screening.
Request
1234567891011121314151617181920
{
"event": "mono.events.watchlist.match_not_found",
"data": {
"match_found": false,
"action": "",
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"profile": {
"type": "individual",
"name": "Chukwuma Adamu",
"date_of_birth": "1941-08-17",
"bvn": "22123412341",
"gender": "male",
"address": "12 Admiralty Way, Lekki",
"country": "ng"
}
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}
Match Updated
Sent when the risk status changes for a monitored subject.
Request
1234567891011121314151617181920
{
"event": "mono.events.watchlist.match_updated",
"data": {
"match_found": true,
"action": "Make a call to the screening result endpoint for more details",
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"profile": {
"type": "individual",
"name": "Chukwuma Adamu",
"date_of_birth": "1941-08-17",
"bvn": "22123412341",
"gender": "male",
"address": "12 Admiralty Way, Lekki",
"country": "ng"
}
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}
Monitoring Created
Sent when monitoring is successfully created for a subject.
Request
123456789101112131415161718
{
"event": "mono.events.watchlist.monitoring_created",
"data": {
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"profile": {
"type": "individual",
"name": "Chukwuma Adamu",
"date_of_birth": "1941-08-17",
"bvn": "22123412341",
"gender": "male",
"address": "12 Admiralty Way, Lekki",
"country": "ng"
}
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}
Monitoring Completed
Sent when monitoring is stopped or completes.
Request
123456789101112131415161718
{
"event": "mono.events.watchlist.monitoring_completed",
"data": {
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"profile": {
"type": "individual",
"name": "Chukwuma Adamu",
"date_of_birth": "1941-08-17",
"bvn": "22123412341",
"gender": "male",
"address": "12 Admiralty Way, Lekki",
"country": "ng"
}
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}
Attempt Failed
Sent when an error occurs while processing the screening.
Request
12345678910
{
"event": "mono.events.watchlist.attempt_failed",
"data": {
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"reason": "An error occurred while fetching identity"
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}
Attempt Completed
Sent when a screening attempt completes.
Request
12345678910111213
{
"event": "mono.events.watchlist.attempt_completed",
"data": {
"id": "aml_scr_9c64b7937f92c96873825371db06a61d",
"type": "individual",
"match_found": true,
"match_score": 100,
"risk_level": "low",
"report_url": "https://abc.com"
},
"app": "6103e431826f2a228d448874",
"business": "60cc8f95ba1772018c5c6b1d"
}