Guides · API

Batch sanctions screening API

Bulk sanctions screening (AML/KYC/KYB) of up to 25 person or organisation names per call (0.0012 USDC per name) against the EU, UN, UK and US OFAC SDN lists, merged and refreshed weekly. Fuzzy matching handles spelling variants and word order; per name: possible match flag, top score and up to 3 scored matches with the lists each is on. For customer onboarding, payouts, vendor and payment screening agents.

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

Parameters

Name	Required	Description
`names`	yes	1 to 25 person or organisation names separated by ';', in Latin letters, e.g. 'Vladimir Putin; Wagner Group; Jan de Vries'
`type`	no	Optional: only persons or only organisations
`threshold`	no	Optional minimum match score 70-100 (default 85)

Example request

curl "https://factline.dev/v1/sanctions/batch?names=Vladimir+Putin%3B+Wagner+Group%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

{
  "count": 3,
  "possible_matches": 2,
  "query": {
    "type": null,
    "threshold": 85
  },
  "results": [
    {
      "name": "Vladimir Putin",
      "screened": true,
      "possible_match": true,
      "top_score": 100,
      "matches": [
        {
          "score": 100,
          "matched_name": "Vladimir Vladimirovich PUTIN",
          "entity": {
            "lists": [
              "EU",
              "UK",
              "US"
            ],
            "references": {
              "EU": "EU.7510.16",
              "UK": "RUS0251",
              "US": "35096"
            },
            "eu_reference": "EU.7510.16",
            "un_id": null,
            "type": "person",
            "names": [
              "Vladimir Vladimirovich PUTIN",
              "Vladimir Vladimirovich POUTINE",
              "Vladimir Vladimirovitj PUTIN"
            ],
            "sanctions_programmes": [
              "UKR",
              "UK The Russia  2019",
              "US OFAC RUSSIA-EO14024"
            ],
            "listed_since": "2022-02-25",
            "birth_dates": [
              "1952-10-07"
            ],
            "countries": [
              "RUSSIAN FEDERATION",
              "Russia"
            ],
            "remark": "(Date of UN designation: 2022-02-25)"
          }
        },
        {
          "score": 95,
          "matched_name": "Maria Vladimirovna PUTINA",
          "entity": {
            "lists": [
              "EU",
              "UK",
              "US"
            ],
            "references": {
              "EU": "EU.7862.80",
              "UK": "RUS1128",
              "US": "36420"
            },
            "eu_reference": "EU.7862.80",
            "un_id": null,
            "type": "person",
            "names": [
              "Maria FAASSEN",
              "Mariya VORONTSOVA",
              "Maria Vladimirovna PUTINA"
            ],
            "sanctions_programmes": [
              "UKR",
              "UK The Russia  2019",
              "US OFAC RUSSIA-EO14024"
            ],
            "listed_since": "2022-04-08",
            "birth_dates": [
              "1985-04-28"
            ],
            "countries": [
              "UNKNOWN",
              "Russia"
            ],
            "remark": "(Date of UN designation: 2022-04-08)"
          }
        }
      ]
    },
    {
      "name": "Wagner Group",
      "
  ...

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 sanctions 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/sanctions/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.