Screen

Is this person or company on a sanctions list, a politically exposed person, under a regulator's action, or in the news for financial crime? Ward answers with every hit, how strong it is, and whether the date of birth and country agree.

Type: screen · Endpoint: POST /api/v1/screen · Real-time

Request

curl https://api.mandatelabs.ai/api/v1/decide \
  -H "X-API-Key: $WARD_API_KEY" -H "Content-Type: application/json" \
  -d '{"type": "screen", "input": {"name": "Ana Maria Perez", "date_of_birth": "1990-05-01", "country": "PAN", "entity_type": "individual"}}'

d = client.decide("screen", {"name": "Ana Maria Perez", "date_of_birth": "1990-05-01", "country": "PAN"})

const d = await client.decide("screen", { name: "Ana Maria Perez", date_of_birth: "1990-05-01", country: "PAN" });

Input

Field	Required	Description
`name`	yes	Full name (2–300 characters)
`date_of_birth`		`YYYY` or `YYYY-MM-DD`: separates namesakes
`country`		Country or nationality (`PAN` or `Panama`)
`entity_type`		`individual` or `organization`; PEP runs on individuals, merchant lists and enforcement on organizations
`external_ref`		Your reference, written to the audit log

Lists

List	Source
Sanctions	OFAC SDN and Consolidated, UN, UK, EU; versioned, refreshed on a schedule
PEP	Current holders of national office; former PEPs, relatives and close associates when OpenSanctions is enabled
Regulatory enforcement	Regulators' actions and warnings, procurement debarment (organizations)
Adverse media	News mentioning the name next to financial-crime terms (when enabled)
WMID	Ward Merchant Intelligence Data: merchants identified as colluding to let fraud through (organizations)

Result

Field	Meaning
`status`	`clear`, `possible_namesake`, `potential_match`, `strong_match`
`hits[]`	`listed_name`, `source`, `score`, `strength`, `programs`, `countries`, `birth_years`, `dob_check`, `country_check` (`match` / `mismatch` / `unknown`)
`pep`, `enforcement`, `adverse_media`, `merchant_lists`	Each list's own status and hits
`checks`	Which lists ran: `checked`, `not_checked`, `failed`, `not_applicable`
`list_versions`	Version of each list used

Decision: clear → APPROVE; possible_namesake or potential_match → STEP_UP; strong_match → DECLINE. A PEP match lifts APPROVE to STEP_UP: a PEP calls for enhanced due diligence, not a block. A contradicted birth year keeps the hit (lists carry errors) but marks it possible_namesake.

Human review

A match on name alone is not a determination that the person is sanctioned. Review potential matches before acting, and never tell the person they matched a list.