AML Screening

Screen individuals against sanctions, PEP, and adverse media sources through the VerifyHQ risk pipeline.

Compliance Note

AML screening is required for regulated financial services in UEMOA and CEMAC zones. Results should be reviewed by your compliance team before making onboarding decisions.

POST/screening/aml/check

Screen an individual against sanctions, PEP, and adverse media databases.

Request Body

Parameter	Type	Description
`userId`required	string	Your internal user identifier
`fullName`required	string	Full legal name of the individual
`dateOfBirth`	string	Date of birth (YYYY-MM-DD) for improved matching accuracy
`nationality`	string	ISO 3166-1 alpha-2 country code
`country`	string	Country where the check should be evaluated
`idNumber`	string	ID or passport number for additional matching

Code Examples

curl -X POST https://api.verifyhq.wejoona.com/screening/aml/check \
  -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",
    "country": "NG",
    "idNumber": "A12345678"
  }'

Response

200 OKjson

{
  "id": "aml_abc123",
  "userId": "user_123",
  "status": "CLEAR",
  "riskLevel": "LOW",
  "matchCount": 0,
  "matches": [],
  "listsChecked": ["SANCTIONS", "PEP", "ADVERSE_MEDIA", "LAW_ENFORCEMENT"],
  "checkedAt": "2026-02-18T13:00:02Z"
}

POST/screening/aml/batch

Screen multiple individuals in a single request (up to 100 per batch).

Request Body

Parameter	Type	Description
`subjects`required	array	Array of AML screening subjects (same fields as single check)

curl -X POST https://api.verifyhq.wejoona.com/screening/aml/batch \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "subjects": [
      { "userId": "user_1", "fullName": "Moussa Konate", "nationality": "ML" },
      { "userId": "user_2", "fullName": "Aicha Toure", "nationality": "SN" }
    ]
  }'

Response

202 Acceptedjson

{
  "batchId": "batch_xyz789",
  "totalSubjects": 2,
  "status": "PROCESSING",
  "createdAt": "2026-02-18T13:00:00Z"
}

GET/screening/aml/:id

Retrieve the result of a specific AML screening.

curl https://api.verifyhq.wejoona.com/screening/aml/aml_abc123 \
  -H "X-API-Key: your_api_key"

Response (with match)

200 OKjson

{
  "id": "aml_def456",
  "userId": "user_456",
  "status": "FLAGGED",
  "riskLevel": "HIGH",
  "matchCount": 1,
  "matches": [
    {
      "listName": "PEP",
      "matchScore": 0.92,
      "matchedName": "Adebayo O. Ogunlesi",
      "category": "POLITICALLY_EXPOSED",
      "details": "Former government official, Nigeria",
      "source": "ECOWAS PEP Database",
      "lastUpdated": "2026-01-10"
    }
  ],
  "checkedAt": "2026-02-18T13:00:02Z"
}

GET/screening/aml/user/:userId

List all AML screening results for a specific user.

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/aml/user/user_123?page=1&limit=10" \
  -H "X-API-Key: your_api_key"

Risk Levels

Parameter	Type	Description
`LOW`	risk	No matches found across all checked lists
`MEDIUM`	risk	Partial or low-confidence matches found — review recommended
`HIGH`	risk	Strong match against sanctions, PEP, or law enforcement lists

Webhook Events

Parameter	Type	Description
`aml.clear`	event	AML screening completed with no matches
`aml.flagged`	event	AML screening found one or more matches
`aml.batch_complete`	event	Batch screening completed