# Greeneris Sanctions Screen

> Greeneris Sanctions Screen is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Screen a person or company name against five major sanctions lists (EU, US OFAC SDN, UN, UK FCDO, French) and return scored matches with a clear verdict.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/screen/sanctions
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-sanctions-screen-799d72e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bVHAhUwdNlI5pgVBoexdi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability greeneris-sanctions-screen-799d72e4
```

Example prompt: Can you screen 'Viktor Petrov' against all five sanctions lists — EU, OFAC, UN, UK, and French — and tell me if there's a match, using a threshold of 0.8?

## When to prefer this

Use this endpoint when you need a single call to cover all five major Western sanctions regimes simultaneously with fuzzy name matching and a clear verdict. Prefer this over building custom integrations with each list individually, especially when daily-refresh freshness is sufficient and you need scored confidence alongside a simple match/no-match decision for KYC, AML, or vendor due diligence workflows.

## Known failure modes

- Missing required 'name' parameter returns a 400 error
- Threshold outside 0.6–1.0 range may return validation error
- Invalid list codes in 'lists' param may be rejected
- Name shorter than 2 or longer than 120 chars rejected
- Daily snapshot may lag same-day designations by up to 24 hours
- Payment failure via x402 protocol blocks the request

## How this service works

Screen a name against the five official sanctions lists (EU, US OFAC SDN, UN, UK FCDO, French asset freezes) from a snapshot refreshed daily, with per-list dates. Query: name=NAME (optional threshold=0.6-1.0, lists=eu,ofac,un,uk,fr). Returns scored matches with entity type and programs, and a verdict: match, possible_match or no_match.

## Output

Returns a verdict of 'match', 'possible_match', or 'no_match', along with a list of scored candidate matches from the queried sanctions lists. Each match includes entity type (individual or organization), sanctions programs, the specific list it appears on, and the date of the list snapshot used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Person or company name to screen (2-120 chars)"
      },
      "lists": {
       "type": "string",
       "description": "Comma-separated subset of eu,ofac,un,uk,fr (default: all)"
      },
      "threshold": {
       "type": "string",
       "description": "Fuzzy match threshold 0.6-1.0 as decimal (default 0.85)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "aerocaribbean airlines",
  "matches": [
   {
    "list": "ofac",
    "score": 1,
    "programs": "CUBA",
    "entity_id": "36",
    "list_label": "US OFAC SDN (Treasury)",
    "entity_type": "entity",
    "matched_name": "AEROCARIBBEAN AIRLINES",
    "primary_name": "AEROCARIBBEAN AIRLINES"
   }
  ],
  "verdict": "match",
  "threshold": 0.85,
  "match_count": 1,
  "verdict_note": "match requires human review",
  "lists_checked": {
   "eu": {
    "as_of": "2026-06-05",
    "names": 30242,
    "entities": 5994
   },
   "ofac": {
    "as_of": "2026-07-10",
    "names": 45000,
    "entities": 19156
   }
  },
  "lists_unavailable": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-sanctions-screen-799d72e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)
