Watchlist Monitoring

Continuous monitoring of individuals against sanctions, PEP, and adverse media lists. Unlike one-time AML screening, watchlist monitoring automatically re-screens subscribed users daily and sends alerts when new matches are found.

Ongoing Due Diligence

Watchlist monitoring fulfills ongoing customer due diligence (CDD) requirements under FATF Recommendation 10 and UEMOA AML directives.

POST/monitoring/watchlist/subscribe

Subscribe a user to continuous watchlist monitoring.

Request Body

Parameter	Type	Description
`userId`required	string	Your internal user identifier
`fullName`required	string	Full legal name
`dateOfBirth`	string	Date of birth (YYYY-MM-DD)
`nationality`	string	ISO 3166-1 alpha-2 country code
`lists`	string[]	Lists to monitor: SANCTIONS, PEP, ADVERSE_MEDIA. Default: all.

curl -X POST https://api.verifyhq.com/v1/monitoring/watchlist/subscribe \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_123",
    "fullName": "Adebayo Ogunlesi",
    "dateOfBirth": "1990-05-15",
    "nationality": "NG"
  }'

Response

201 Createdjson

{
  "id": "wl_sub_abc123",
  "userId": "user_123",
  "status": "ACTIVE",
  "lists": ["SANCTIONS", "PEP", "ADVERSE_MEDIA"],
  "nextScanAt": "2026-02-19T02:00:00Z",
  "createdAt": "2026-02-18T13:00:00Z"
}

DELETE/monitoring/watchlist/subscribe/:id

Unsubscribe a user from watchlist monitoring.

curl -X DELETE https://api.verifyhq.com/v1/monitoring/watchlist/subscribe/wl_sub_abc123 \
  -H "X-API-Key: your_api_key"

Response

200 OKjson

{
  "id": "wl_sub_abc123",
  "status": "CANCELLED",
  "cancelledAt": "2026-02-18T14:00:00Z"
}

GET/monitoring/watchlist/alerts

List watchlist alerts (new matches found during monitoring).

Query Parameters

Parameter	Type	Description
`userId`	string	Filter by user ID
`status`	enum	Filter by alert status: OPEN, REVIEWED, DISMISSED
`page`	number	Page number (default: 1)
`limit`	number	Items per page (default: 20, max: 100)

curl "https://api.verifyhq.com/v1/monitoring/watchlist/alerts?status=OPEN&page=1" \
  -H "X-API-Key: your_api_key"

Response

200 OKjson

{
  "data": [
    {
      "id": "alert_xyz789",
      "subscriptionId": "wl_sub_abc123",
      "userId": "user_123",
      "status": "OPEN",
      "match": {
        "listName": "SANCTIONS",
        "matchScore": 0.94,
        "matchedName": "Adebayo Ogunlesi",
        "source": "OFAC SDN List",
        "addedDate": "2026-02-17"
      },
      "detectedAt": "2026-02-18T02:05:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 1 }
}

GET/monitoring/watchlist/subscriptions

List all active watchlist monitoring subscriptions.

Query Parameters

Parameter	Type	Description
`status`	enum	ACTIVE or CANCELLED
`page`	number	Page number (default: 1)
`limit`	number	Items per page (default: 20, max: 100)

curl "https://api.verifyhq.com/v1/monitoring/watchlist/subscriptions?status=ACTIVE" \
  -H "X-API-Key: your_api_key"

Webhook Events

Parameter	Type	Description
`watchlist.alert`	event	New match detected during continuous monitoring
`watchlist.clear`	event	Previously flagged match removed from watchlists