Screen for PEPs
Screening
Screen for PEPs
Screen a person’s name against the OpenSanctions politically exposed persons dataset
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.
Unlike the other
Results are provided by OpenSanctions; each match’s
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).
/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
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.