# Novarithm Sanctions Screening API

> Novarithm Sanctions Screening API is a paid API for AI agents from api.novarithm.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-13).

Screens a person or entity name against OFAC, UN, EU, and UK sanctions lists and returns match results with confidence scores

## Facts

- Endpoint: GET https://api.novarithm.com/agents/v1/sanctions/screen?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/novarithm-sanctions-screening-api-669f9566
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YDuoYFvWZvYHWUuSVxeQJ

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 novarithm-sanctions-screening-api-669f9566
```

Example prompt: Can you check if 'Bank Rossiya' is on any sanctions list — screen it as an entity across all OFAC, UN, EU, and UK lists with a match threshold of 85?

## When to prefer this

Use this endpoint when you need real-time, pay-per-call sanctions screening against the four major official lists (OFAC, UN, EU, UK) with configurable fuzzy matching, subject type filtering, and country/birth year boosting — especially in automated compliance workflows or agent pipelines where you want structured JSON output with match scores rather than a managed SaaS dashboard.

## Known failure modes

- Name not provided — returns 400 or validation error
- Threshold below 60 or above 100 — rejected by schema validation
- Invalid list name in 'lists' parameter — may return list_errors array
- Network timeout or service unavailability — no response or 5xx error
- Name contains non-Latin script — may produce no results or low-quality matches

## How this service works

Novarithm installe l'IA dans votre entreprise : elle répond à vos clients, trouve de nouveaux clients et fait le répétitif. Payés sur vos résultats.

## Output

Returns a JSON object with a status field ('clear', 'potential_match', etc.), a list of matching entries with details, the top match score (0-100), the number of matches found, which lists were checked, the query echo, a disclaimer, and metadata including response time and billing unit.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Person or company name, Latin script"
      },
      "type": {
       "enum": [
        "any",
        "person",
        "entity",
        "vessel",
        "aircraft"
       ],
       "type": "string",
       "default": "any",
       "description": "Restrict to a subject type"
      },
      "lists": {
       "type": "string",
       "description": "Comma list among ofac,un,eu,uk (default all)"
      },
      "country": {
       "type": "string",
       "description": "ISO-2 country (or name) of the subject, boosts/penalises matches"
      },
      "threshold": {
       "type": "integer",
       "default": 85,
       "maximum": 100,
       "minimum": 60,
       "description": "Minimum match score 0-100 (default 85)"
      },
      "birth_year": {
       "type": "integer",
       "maximum": 2026,
       "minimum": 1900,
       "description": "Birth year of a person, boosts/penalises matches"
      },
      "max_results": {
       "type": "integer",
       "default": 10,
       "maximum": 50,
       "minimum": 1,
       "description": "Max matches returned"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": {
    "name": "Bank Rossiya",
    "type": "entity",
    "country": null,
    "threshold": 85,
    "birth_year": null
   },
   "status": "potential_match",
   "matches": [
    {}
   ],
   "sources": [
    {}
   ],
   "price_usd": 0.01,
   "top_score": 100,
   "disclaimer": "Automated name screening against official lists: a potential match is a signa...",
   "list_errors": [],
   "match_count": 4,
   "billing_unit": "name screened (4 lists)",
   "generated_at": "2026-10-23T10:03:37Z",
   "lists_checked": [
    {}
   ],
   "response_time_ms": 148
  },
  "service": "sanctions_screen"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/novarithm-sanctions-screening-api-669f9566/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.novarithm.com](https://www.zero.xyz/host/api.novarithm.com/llms.txt)
