Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Compliance & Business Live on Hub

Sanctions, Watchlist & Embargo Entity Screener API — Fuzzy KYB/AML Pre-Screening

Screen beneficiaries, vendors, BICs, and wallets against embargo rules and fuzzy sanctions watchlists. Screen company and individual names, countries, BIC/SWIFT codes, and crypto wallets against embargoed jurisdictions, sanctioned banks, and fuzzy Jaro-Winkler + token-set watchlist matching.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/sanctions-screenerinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "clear": false,
    "verdict": "block",
    "risk_score": 100,
    "normalized_query": "vtb bank",
    "phonetic_key": "FTPPNK",
    "jurisdiction_risk": {
      "country_code": "RU",
      "level": "high_sanctioned",
      "flags": [
        "EU_SECTORAL_SANCTIONS",
        "OFAC_RUSSIA_SANCTIONS"
      ]
    },
    "total_matches": 1,
    "matches": [
      {
        "entry_id": "OFAC-SDN-VTB-001",
        "matched_name": "VTB Bank Public Joint Stock Company",
        "entity_type": "company",
        "lists": [
          "OFAC_SDN",
          "EU_FSF",
          "UK_OFSI"
        ],
        "match_method": "exact_identifier",
        "similarity_score": 1,
        "program": "RUSSIA-EO14024 / EU Regulation 833/2014"
      }
    ],
    "coverage": {
      "builtin_entries": 16,
      "custom_entries": 0,
      "data_as_of": "2026-11-16",
      "scope": "high_profile_pre_screening",
      "note": "Screened against 16 high-profile built-in entries + 0 custom_watchlist entries. Not a substitute for full consolidated OFAC/EU/UN licensing feeds."
    }
  },
  "meta": {
    "request_id": "req_sanc_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/sanctions-screener" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"entity_name":"VTB Bank PJSC","entity_type":"company","country_code":"RU","identifiers":{"bic":"VTBRRUMM"},"similarity_threshold":0.84}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/sanctions-screener", {
  "entity_name": "VTB Bank PJSC",
  "entity_type": "company",
  "country_code": "RU",
  "identifiers": {
    "bic": "VTBRRUMM"
  },
  "similarity_threshold": 0.84
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/sanctions-screener",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "entity_name": "VTB Bank PJSC",
  "entity_type": "company",
  "country_code": "RU",
  "identifiers": {
    "bic": "VTBRRUMM"
  },
  "similarity_threshold": 0.84
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/sanctions-screener", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "entity_name": "VTB Bank PJSC",
  "entity_type": "company",
  "country_code": "RU",
  "identifiers": {
    "bic": "VTBRRUMM"
  },
  "similarity_threshold": 0.84
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_sanctions_screener",
    "arguments": {
      "entity_name": "VTB Bank PJSC",
      "entity_type": "company",
      "country_code": "RU",
      "identifiers": {
        "bic": "VTBRRUMM"
      },
      "similarity_threshold": 0.84
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/sanctions-screener)

ParameterType & ConstraintsDescription
entity_name required string
minLen: 2, maxLen: 512
Company, organization, vessel, or individual name to screen.
entity_type optional "any" | "company" | "individual" | "vessel"
default: "any"
Field 'entity_type'
country_code optional string
minLen: 2, maxLen: 2
Optional 2-letter ISO country code to evaluate jurisdiction embargo and FATF risk.
identifiers optional object Optional structured financial or corporate identifiers for exact watchlist matching.
custom_watchlist optional object[] Optional caller-provided watchlist entries to fuzzy-screen alongside built-in EU/OFAC/UN/UK designations.
similarity_threshold optional number
min: 0.5, max: 1, default: 0.84
Minimum normalized Jaro-Winkler / phonetic similarity score (0.50..1.00) to report a name match.

Response data Object Fields (200 OK)

FieldTypeDescription
clear boolean Field 'clear'
verdict "clear" | "review" | "block" Field 'verdict'
risk_score number Field 'risk_score'
normalized_query string Field 'normalized_query'
phonetic_key string Field 'phonetic_key'
jurisdiction_risk object Field 'jurisdiction_risk'
total_matches integer Field 'total_matches'
matches object[] Field 'matches'
coverage object Field 'coverage'

What Sanctions, Watchlist & Embargo Entity Screener API Detects & Validates

  • Comprehensive and sectoral jurisdiction embargo detection (KP, IR, SY, CU, RU, BY, VE, MM, AF, SD, YE, ZW)
  • Legal suffix normalization (GmbH, Ltd, LLC, PJSC, Kft, S.A., B.V.) plus Jaro-Winkler + token-subset similarity scoring
  • Sanctioned bank BIC/SWIFT prefix screening and OFAC-designated Tornado Cash / Lazarus crypto address matching
  • Custom caller-supplied watchlist array support for internal blocklists and PEP screening
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Provides deterministic embargo, BIC, wallet, and high-profile OFAC/EU/UN entity pre-screening plus custom watchlist fuzzy matching; regulated financial institutions must pair this with live full-SDN XML feed ingestion.
  • Tested v1.0.6 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Can I pass my own internal watchlist or high-risk vendor list?

Yes—pass up to 500 entries in custom_watchlist and the engine applies the same legal-suffix stripping and Jaro-Winkler + token-subset matching.

Why does legal suffix stripping matter for KYB screening?

Standard string distance fails when 'Rosneft Oil Company PJSC' is compared against 'Rosneft'. Stripping corporate suffixes prevents trivial evasion.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Screened entity names and identifiers are evaluated in memory and never logged or retained.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/eu-vat-iban/iban Live

EU VAT & IBAN/BIC Validator API

Validate IBANs, BIC/SWIFT codes, and EU/UK VAT numbers with live EU VIES lookup.

POST /v1/eu-id-validator Tier 1

European Corporate Tax, LEI, EORI & National ID Validator API

Validate LEI, EORI, SIREN/SIRET, Steuer-ID, Codice Fiscale, NIF/CIF, NIP, BSN, CRN & EIN checksums.

POST /v1/hu-business-validator Compliance & Business

Hungarian Business Document & NAV Validator API

Validate Hungarian adószám, cégjegyzékszám, GIRO bank accounts, and NAV invoice rules.