# Sanctions Screening + EU VAT + IBAN Check (OFAC, UN, UK, EU) (`henrycrawl/sanctions-vat-iban-check`) Actor

Screen people and companies against official sanctions lists (US OFAC SDN, UN Security Council, UK, EU) with fuzzy name matching, validate EU VAT numbers live in VIES and check IBANs. Clean JSON with match scores for KYC / KYB, AI agents and onboarding. Pay per check.

- **URL**: https://apify.com/henrycrawl/sanctions-vat-iban-check.md
- **Developed by:** [Henry Crawl](https://apify.com/henrycrawl) (community)
- **Categories:** AI, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 name screeneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Sanctions Screening + EU VAT + IBAN Check (OFAC, UN, UK, EU)

**Screen people and companies against the official sanctions lists, validate EU VAT numbers and check IBANs in
one call.** Built for KYC / KYB onboarding, supplier checks, payment pre-checks and AI agents that must not deal
with a sanctioned party.

- **Sanctions lists, downloaded fresh from the official source every run:**
  - 🇺🇸 US OFAC Specially Designated Nationals (SDN), including all aliases
  - 🇺🇳 UN Security Council Consolidated List
  - 🇬🇧 UK Sanctions List (FCDO / OFSI)
  - 🇪🇺 EU Financial Sanctions consolidated list (optional, slower download)
- **Fuzzy name matching:** first / last name order, punctuation, accents, legal forms (Ltd, PJSC, LLC…) and
  common honorifics are ignored. Each match has a 0-100 score and a strength label.
- **EU VAT check:** live in the European Commission's VIES service, with registered name and address where the
  member state publishes them.
- **IBAN check:** length per country, mod-97 checksum, bank code, SEPA membership.

### Input

```json
{
  "names": ["Banco Nacional de Cuba", "Acme Trading Ltd", "Ivan Petrov"],
  "lists": ["OFAC", "UN", "UK"],
  "minScore": 85,
  "entityType": "any",
  "vatNumbers": ["FR40303265045", "DE811115368"],
  "ibans": ["DE89 3704 0044 0532 0130 00"]
}
```

### Output

**Screening row (one per name):**

```json
{
  "type": "screening",
  "status": "OK",
  "input": "Banco Nacional de Cuba",
  "hit": true,
  "matchCount": 1,
  "topScore": 100,
  "topMatchStrength": "exact",
  "matches": [{
    "list": "OFAC",
    "listName": "US OFAC Specially Designated Nationals (SDN)",
    "reference": "306",
    "type": "entity",
    "name": "BANCO NACIONAL DE CUBA",
    "aliases": ["NATIONAL BANK OF CUBA"],
    "matchedName": "BANCO NACIONAL DE CUBA",
    "matchScore": 100,
    "matchStrength": "exact",
    "programs": ["CUBA"],
    "url": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=306"
  }],
  "listsChecked": ["OFAC", "UN", "UK"],
  "scrapedAt": "2026-11-16T07:00:00Z"
}
```

A name with no match returns `"hit": false` and an empty `matches` list: that is the "clear" answer, and it is
recorded with the lists and threshold used.

**VAT row:** `vatNumber`, `valid`, `name`, `address`, `checkedAt`. **IBAN row:** `iban`, `valid`, `reason`,
`bankCode`, `sepa`.

### Pricing

- **$0.004 per name screened** (against every selected list).
- **$0.01 once per run** when names are screened (downloading and indexing the official lists).
- **$0.003 per VAT number** checked in VIES. **$0.0005 per IBAN.**
- Free: VAT numbers VIES could not check (busy, bad format), and any screening where a requested list failed to
  download (`PARTIAL_LISTS`: not safe to rely on, so not charged).

Screening 100 names costs $0.41.

### Data and privacy

Only official designation data is returned: names and aliases, type, sanctions programme, nationality, birth date
and listing date as published by the authorities. Addresses, phone numbers, e-mail addresses and identity-document
numbers in the source lists are not loaded or returned.

### Use with AI agents (MCP)

`https://mcp.apify.com/?tools=henrycrawl/sanctions-vat-iban-check` — e.g. `{"names": ["<counterparty>"], "vatNumbers": ["<VAT>"]}`.

### Important

This tool reports similarity to official lists; a match is a signal for review, not a legal determination.
Always confirm a hit against the official entry (`url`) and your compliance procedures.

# Actor input Schema

## `names` (type: `array`):

People or company names to check against the sanctions lists (any order of first / last name; transliteration differences are tolerated).

## `lists` (type: `array`):

Official lists to screen against. Default: OFAC, UN, UK (downloaded fresh each run). The EU list adds about 1-2 minutes of download time.

## `minScore` (type: `integer`):

0-100 name similarity needed to report a match (85 = recommended balance; 95+ = near-exact only). Very short names always need 95.

## `entityType` (type: `string`):

Restrict matches to one kind of listed party.

## `maxMatchesPerName` (type: `integer`):

Best matches returned for each screened name.

## `vatNumbers` (type: `array`):

VAT numbers with country prefix (e.g. FR40303265045, DE811115368) checked live in the European Commission's VIES service.

## `ibans` (type: `array`):

IBANs to validate (length per country, mod-97 checksum), with bank code and SEPA membership.

## Actor input object example

```json
{
  "names": [
    "Banco Nacional de Cuba",
    "Acme Trading Ltd"
  ],
  "minScore": 85,
  "entityType": "any",
  "maxMatchesPerName": 10
}
```

# Actor output Schema

## `results` (type: `string`):

One row per screened name, VAT number and IBAN.

## `lists` (type: `string`):

Which sanctions lists were loaded and how many designations each had (LISTS record).

## `summary` (type: `string`):

Counts for this run (SUMMARY record).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "names": [
        "Banco Nacional de Cuba",
        "Acme Trading Ltd"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("henrycrawl/sanctions-vat-iban-check").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "names": [
        "Banco Nacional de Cuba",
        "Acme Trading Ltd",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("henrycrawl/sanctions-vat-iban-check").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "names": [
    "Banco Nacional de Cuba",
    "Acme Trading Ltd"
  ]
}' |
apify call henrycrawl/sanctions-vat-iban-check --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,henrycrawl/sanctions-vat-iban-check"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8jzx09ROBCzRA9j6f/builds/MKDsEa7jz72ZJA2Zr/openapi.json
