Guides · API

Batch PEP screening API

Batch PEP screening of up to 25 names per call (0.0012 USDC per name) against Factline's Wikidata-based PEP extract: top 3 possible matches per name with positions and status. For customer-base and CRM re-screening pipelines.

0.03 USDC per call · GET /v1/pep/batch · free preview at /v1/pep/batch/preview

Parameters

Name	Required	Description
`names`	yes	Up to 25 names separated by ';', e.g. Mark Rutte; Jan de Vries

Example request

curl "https://factline.dev/v1/pep/batch?names=Mark+Rutte%3B+Jan+de+Vries"
# 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 Batch PEP screening cost?

0.03 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/batch/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.