Skip to main content
GET
Screen for PEPs
Screens a person’s name against the OpenSanctions politically exposed persons (PEPs) dataset with scored query-by-example matching — current and former public officials, their relatives and close associates. Use it during KYC onboarding or enhanced due diligence.
string
required
Full name of the person to screen (2–200 characters).
string
Birth date to sharpen matching — YYYY-MM-DD, or partial (e.g. 1961).
string
Country of citizenship or residence, by name or ISO code.
integer
Maximum candidates to return (1–10, default 5).
Unlike the other /screen/* endpoints, this is a live proxy of an external dataset rather than a query against our ingested lists, so it takes no lists filter and returns its own envelope instead of the shared screening envelope: each candidate carries a score (0–1), match is true when the score clears the 0.7 decision threshold, and the top-level pep is true when any candidate matches. PEP status is not a sanctions designation — screen names against sanctions lists with /search and the other /screen/* endpoints.
Example response
Results are provided by OpenSanctions; each match’s source_url links to its OpenSanctions entity page. With x402 pay-per-request enabled, this endpoint is priced higher than the default per-call price (the upstream dataset is metered per query) — the amount in the 402 challenge is always authoritative.