> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compliapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Screen for PEPs

> Screen a person's name against the OpenSanctions politically exposed persons dataset

Screens a person's name against the [OpenSanctions](https://www.opensanctions.org) 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.

<ParamField query="name" type="string" required>
  Full name of the person to screen (2–200 characters).
</ParamField>

<ParamField query="birth_date" type="string">
  Birth date to sharpen matching — `YYYY-MM-DD`, or partial (e.g. `1961`).
</ParamField>

<ParamField query="country" type="string">
  Country of citizenship or residence, by name or ISO code.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum candidates to return (1–10, default 5).
</ParamField>

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](/api/screen): 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`](/api/search) and the other `/screen/*` endpoints.

```json Example response theme={null}
{
  "value": "Saddam Hussein",
  "pep": true,
  "dataset": "peps",
  "matches": [
    {
      "id": "Q1316",
      "caption": "Saddam Hussein AL-TIKRITI",
      "score": 0.98,
      "match": true,
      "topics": ["role.pep"],
      "countries": ["iq"],
      "birth_dates": ["1937-04-28"],
      "positions": ["President of Iraq"],
      "datasets": ["wikidata", "wd_peps"],
      "source_url": "https://www.opensanctions.org/entities/Q1316/"
    }
  ]
}
```

Results are provided by [OpenSanctions](https://www.opensanctions.org); each match's `source_url` links to its OpenSanctions entity page.

With [x402 pay-per-request](/payments) 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.