Guides · API

Screen up to 100 names against the EU, UN, UK and US sanctions lists and the PEP list in one call, paid per name ($0.0012 per name per list, metered).

Use to re-screen a customer or supplier list: up to 100 names per call against the EU, UN, UK and US OFAC sanctions lists and the PEP list, with possible matches per name. Metered: $0.0012 per name per list; the 402 quotes the 100-name cap and you pay only for the names sent. Input: names separated by ';', optional lists (both, sanctions or pep), type, threshold.

0.24 USDC per call · GET /v1/screen/bulk · free preview at /v1/screen/bulk/preview

Parameters

Name	Required	Description
`names`	yes	Up to 100 names separated by ';'
`lists`	no	Which lists (default both)
`type`	no
`threshold`	no	Match score 70 to 100 (default 85)

Example request

curl "https://factline.dev/v1/screen/bulk?names=Vladimir+Putin%3BFactline%3BJan+de+Vries&lists=both"
# 402 Payment Required: pay with an x402 client (USDC on Base or Solana), or send
# Authorization: Bearer <your Factline API key>

Example response

{
  "count": 3,
  "flagged": 1,
  "lists": [
    "sanctions (EU, UN, UK, US OFAC)",
    "PEP"
  ],
  "results": [
    {
      "name": "Vladimir Putin",
      "flagged": true,
      "sanctions": {
        "possible_match": true,
        "top_score": 100,
        "matches": []
      },
      "pep": {
        "possible_match": true,
        "matches": []
      }
    },
    {
      "name": "Factline",
      "flagged": false,
      "sanctions": {
        "possible_match": false,
        "top_score": null,
        "matches": []
      },
      "pep": {
        "possible_match": false,
        "matches": []
      }
    }
  ],
  "charged_usd": 0.0072
}

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 Screen up to 100 names against the EU, UN, UK and US sanctions lists and the PEP list in one call, paid per name ($0.0012 per name per list, metered). cost?

0.24 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/screen/bulk/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.