Watchlist Monitoring

Continuous monitoring of individuals against sanctions, PEP, and adverse media sources. Unlike one-time AML screening, watchlist monitoring keeps a subscription active and exposes 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/screening/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
`country`	string	Country where the monitoring subject should be evaluated

curl -X POST https://api.verifyhq.wejoona.com/screening/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/screening/watchlist/unsubscribe/:id

Unsubscribe a user from watchlist monitoring.

curl -X DELETE https://api.verifyhq.wejoona.com/screening/watchlist/unsubscribe/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/screening/watchlist/alerts

List watchlist alerts (new matches found during monitoring).

Query Parameters

Parameter	Type	Description
`page`	number	Page number (default: 1)
`limit`	number	Items per page (default: 20, max: 100)

curl "https://api.verifyhq.wejoona.com/screening/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/screening/watchlist/subscriptions

List all active watchlist monitoring subscriptions.

Query Parameters

Parameter	Type	Description
`page`	number	Page number (default: 1)
`limit`	number	Items per page (default: 20, max: 100)

curl "https://api.verifyhq.wejoona.com/screening/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