Sanctions screening API for AI agents
Screen any person or company name against the five major official sanctions lists in one call: the EU consolidated financial sanctions, US OFAC SDN, UN Security Council, UK FCDO Sanctions List and the French national asset freezes. Matching is fuzzy and insensitive to accents and word order, with per-list refresh dates included so you know how fresh each answer is.
Sanctions screening is a legal obligation for any business exposed to the EU or US, and no one else sells it agent-native below a few tens of cents. Here it is $0.01 per call in USDC, no account, no API key. The result is a screening aid (match, possible_match or no_match with scores) - a positive match needs human review of date of birth and nationality before any decision.
Endpoint
GET /v1/screen/sanctions — $0.01 per call (USDC on Base, x402). Also available as the MCP tool screen_sanctions on https://data.greeneris.io/mcp.
Parameters
| Param | Description |
|---|---|
name | Person or company name to screen (required, 2-120 chars) |
threshold | Fuzzy match threshold 0.6-1.0 as a decimal (default 0.85) |
lists | Optional subset of eu,ofac,un,uk,fr (default: all five) |
Example
curl -i "https://data.greeneris.io/v1/screen/sanctions?name=hezbollah"
# HTTP/1.1 402 Payment Required + machine-readable quote
# (any x402 client pays the quote and retries automatically)Response after payment:
{"ok": true, "data": {"query": "hezbollah", "verdict": "match", "match_count": 1, "matches": [{"list": "eu", "primary_name": "HIZBALLAH", "entity_type": "entity", "score": 0.95}], "lists_checked": {"eu": {"entities": 5994, "as_of": "2026-07-15"}}}}What agents use it for
- AML/KYB pipelines: screen a counterparty before onboarding or payment
- Screen the beneficial owners and directors surfaced by a company lookup
- Batch-screen an existing supplier or customer base against fresh lists
How payment works
Call the endpoint: you get HTTP 402 with a signed quote (price, receiving address, network). Your agent pays a few tenths of a cent in USDC on Base (gasless, EIP-3009) and retries - one round trip, no account, no API key. Settlement only happens after a successful answer. Full catalog: llms.txt.