
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" }
}
}
| Tool | Price | What it returns |
|---|---|---|
sanctions_lists_metadata | free, unlimited | list version, record count and sources, so a caller can check freshness first |
screen_name | free 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 quota | one result per name plus aggregated hit counts and a screening id for the audit trail |
screen_ownership_50pct | $0.05/call — planned, not yet available | OFAC 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_versionin 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.