Repository avatar
AI Tools
v0.11.1
active

sanctions-screening-api

io.github.CooLCHI-gun/sanctions-screening-api

Sanctions screening of any person or company against OFAC SDN, EU and UN lists. Free quota.

Documentation

Sanctions Screening API

Real-time sanctions screening against OFAC SDN, EU Consolidated, and UN Security Council lists — 26,000+ records, updated daily. Built for fintech, payments, and compliance teams.

▶ Try it live on RapidAPI: rapidapi.com/CooLCHI-gun/api/sanctions-screening-api2 ▶ Live health check: https://sanc.mooocopy.com/ready

▶ Use it from an AI agent (MCP, no API key): https://sanc.mooocopy.com/mcp


MCP — for AI agents

The same screening engine is exposed as a remote MCP server (Streamable HTTP), so an agent can screen names with no API key and no signup:

{
  "mcpServers": {
    "sanctions": { "url": "https://sanc.mooocopy.com/mcp" }
  }
}
ToolPriceWhat it returns
sanctions_lists_metadatafree, unlimitedlist version, record count and sources, so a caller can check freshness first
screen_namefree within a small daily quota, then $0.002/call via x402 (USDC on Base)ranked candidates with match tier (exact / alias / fuzzy / fuzzy-alias), confidence and source attribution
screen_batch$0.02/call, up to 100 names, no free quotaone result per name plus aggregated hit counts and a screening id for the audit trail
screen_ownership_50pct$0.05/call — planned, not yet availableOFAC 50 Percent Rule check: owned 50%+ in aggregate by designated persons, so not itself on any list

Discovery descriptor: https://sanc.mooocopy.com/.well-known/mcp.json · price table: https://sanc.mooocopy.com/catalog

Example:

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"screen_name","arguments":{"query_name":"Vladimir Putin"}}}

→ Vladimir PUTIN · OFAC-SDN · match_type: alias · confidence 0.9 · ref 35096

This repository shows the public API surface and architecture of the Sanctions Screening service. The production service is available via RapidAPI (or the remote MCP server above) — subscribe or call it to use the full engine (exact + alias + fuzzy name matching, optional LLM review of borderline candidates, multi-tenant audit trail). The core matching engine, data pipeline, and provider implementations are proprietary and not included here.


Features

  • 3 global lists, 1 call — OFAC SDN, EU Consolidated, UN Security Council. No multi-vendor integration.
  • Fresh, verifiable data — every response carries data_version + sources_covered; lists re-fetched daily from official sources.
  • Audit trail — append-only, queryable log of every screening (compliance-ready).
  • Custom watchlists — upload per-tenant CSV lists, screened alongside global lists.
  • Review queue — high-confidence sanctions hits (>= 0.9) auto-flag for human review.
  • Multi-tenant — per-tenant API keys, rate limits, LLM cascade opt-in (privacy by default).

Quickstart

# Screen a name against all lists
curl -X POST "https://sanctions-screening-api2.p.rapidapi.com/screen" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: <YOUR_RAPIDAPI_KEY>" \
  -H "X-RapidAPI-Host: sanctions-screening-api2.p.rapidapi.com" \
  -H "X-API-Key: <YOUR_TENANT_KEY>" \
  -d '{"query_name": "Kim Jong Un", "threshold": 0.8}'

Tenant keys are issued during RapidAPI onboarding. See API guide for the full endpoint reference.

Architecture

                 ┌─────────────────────────────────────────────┐
                 │            RapidAPI Gateway                 │
                 │  (auth, billing, X-RapidAPI-Proxy-Secret)   │
                 └──────────────────┬──────────────────────────┘
                                    │ HTTPS
                 ┌──────────────────▼──────────────────────────┐
                 │           HTTP API layer (this repo)        │
                 │  /screen  /watchlists  /cases  /audit       │
                 │  middleware: proxy-secret, admin-key,       │
                 │  rate-limit, body-limit, sanitizers         │
                 └──────┬──────────────┬──────────────┬────────┘
                        │              │              │
        ┌───────────────▼───┐  ┌───────▼───────┐  ┌───▼────────────┐
        │  Matching engine  │  │  Tenant store │  │  Audit / Review│
        │  (proprietary)    │  │  (SQLite)     │  │  (SQLite)      │
        │  fuzzy matching   │  │  keys, tiers  │  │  append-only   │
        └───────────────┬───┘  └───────────────┘  └────────────────┘
                        │
        ┌───────────────▼───────────────────────────────┐
        │  Data pipeline (proprietary)                  │
        │  OFAC + EU + UN → normalize → merge → deploy  │
        └───────────────────────────────────────────────┘

This repo includes: HTTP API handlers, middleware, tenant/auth, watchlist, audit, review, models, config, bootstrap wiring — the request-handling layer.

Proprietary (not included): matching pipeline (exact + alias + fuzzy matching, optional LLM review), provider implementations (OFAC/EU/UN fetch + normalize), data update scripts, deployment tooling.

Repository layout

internal/
├── httpapi/     # Handlers + middleware (proxy secret, admin key, rate limit)
├── tenant/      # Per-tenant API keys, tiers (SHA-256 hashed)
├── audit/       # Append-only SQLite audit trail (WAL)
├── watchlist/   # CSV upload + versioning
├── review/      # Case review queue (pending/approved/rejected)
├── models/      # Domain types
├── config/      # Env-based config
└── bootstrap/   # Startup wiring
openapi/         # OpenAPI 3.0.3 spec (also powers the RapidAPI listing)
docs/            # Architecture + API guide
examples/        # Client code samples

Data freshness

  • Lists re-fetched daily (03:30 UTC) from official sources.
  • data_version in every response (e.g. 2026-08-07).
  • Sources: OFAC SDN (treasury.gov), EU Consolidated FSF, UN Security Council Consolidated List.

License

PolyForm Shield 1.0.0 — source-available. You may read, use, and modify the code for non-competing purposes. You may not use it to offer a competing sanctions-screening product or service. See LICENSE.

For commercial licensing (full engine incl. matching + data pipeline), contact via RapidAPI.

Security

See SECURITY.md for responsible disclosure.

No installation packages available.

Remote