Guides · API

PEP screening API (politically exposed persons)

PEP screening for AML/KYC agents from Factline's weekly Wikidata extract (CC0): heads of state and government and ministers of every country, central bank governors, MEPs, and national MPs of the EU, EEA, UK, US and Switzerland. Fuzzy name matching with scores, positions with country and dates, in office or former (default 5 years, years=1-10), optional birth_year and country. Pairs with /v1/sanctions/screen.

0.005 USDC per call · GET /v1/pep/screen · free preview at /v1/pep/screen/preview

Parameters

Name	Required	Description
`name`	yes	Person's full name in Latin letters, e.g. Mark Rutte
`birth_year`	no	Optional birth year to sharpen matches, e.g. 1967
`country`	no	Optional ISO country to prefer, e.g. NL
`years`	no	Years after leaving office still counted as PEP, 1-10 (default 5)

Example request

curl "https://factline.dev/v1/pep/screen?name=Mark+Rutte"
# 402 Payment Required: pay with an x402 client (USDC on Base), or send
# Authorization: Bearer <your Factline API key>

Example response

{
  "query": {
    "name": "Mark Rutte",
    "birth_year": null,
    "country": null,
    "former_years": 5,
    "threshold": 85
  },
  "possible_match": true,
  "matches": [
    {
      "score": 100,
      "matched_name": "Mark Rutte",
      "person": {
        "name": "Mark Rutte",
        "wikidata": "Q57792",
        "url": "https://www.wikidata.org/wiki/Q57792",
        "birth_year": 1967,
        "pep_class": "head_of_government",
        "pep_class_label": "head of government",
        "status": "former, left on 2024-07-02",
        "current": false,
        "countries": [
          "NL"
        ],
        "positions": [
          {
            "class": "head_of_government",
            "country": "NL",
            "title": "Prime Minister of the Netherlands",
            "start": "2010-10-14",
            "end": "2024-07-02"
          }
        ]
      }
    }
  ],
  "coverage": {
    "people": 40000,
    "by_class": {
      "head_of_state": 400,
      "head_of_government": 450,
      "minister": 9000,
      "legislator": 28000
    },
    "former_years": 5
  },
  "disclaimer": "Automated PEP screening aid built from Wikidata, not legal advice. Being a politically exposed person is not an allegation of wrongdoing.",
  "source": "Wikidata (CC0), extracted weekly by Factline"
}

Use it from an AI agent

Agents with an x402 wallet call the URL directly and pay per request. Assistants that speak MCP connect to https://factline.dev/mcp. Full reference: docs, OpenAPI, llms.txt. Businesses: API keys with a free trial.

Questions

How much does the PEP screening API (politically exposed persons) cost?

0.005 USDC per call, paid per request with x402 (no account), or included in a Factline API key plan with a free trial. Calls that fail are not charged.

Can I try it for free?

Yes: GET /v1/pep/screen/preview with the same parameters validates your input and shows what the paid answer contains, at no cost.

Where does the data come from?

Official public registers and open data, named with their licence in every response (source field) and at /.well-known/x402-license-provenance.