OFAC Screening API and SDN List API Reference

curl -X POST https://screenveritai.com/api/v1/search \
  -H "X-API-Key: svai_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_name": "Test Person",
    "entity_type": "person",
    "search_type": "sanctions_check",
    "country": "PL"
  }'

# HTTP/1.1 202 Accepted
# X-RateLimit-Limit: 60
# X-RateLimit-Remaining: 59
# X-RateLimit-Reset: 1788519240
#
# {
#   "search_id": "8f2a1c34-0d6b-4f7e-9a52-6c1e0b3d5a77",
#   "status": "processing",
#   "message": "Search queued successfully. Poll the GET endpoint for results.",
#   "estimated_time_seconds": 15
# }

{
  "id": "8f2a1c34-0d6b-4f7e-9a52-6c1e0b3d5a77",
  "entity_name": "Test Person",
  "entity_type": "person",
  "status": "completed",
  "search_type": "sanctions_check",
  "final_report": null,
  "news_summary": null,
  "ofac_sanctions": "## OFAC Sanctions Findings\n\n**Status:** *No relevant listing found*\n\n**Details:**\n- No relevant listing was found in this source for the searched entity.\n\n**Source:** *OFAC Sanctions*",
  "sanctions_sources": [
    {
      "source_id": "ofac_sanctions",
      "title": "OFAC Sanctions",
      "authority": "",
      "details": "## OFAC Sanctions Findings ...",
      "hit_count": 0
    }
  ],
  "criminal_watchlists": null,
  "pep": null,
  "relationships": "",
  "created_at": "2026-09-04T09:12:44.118000+00:00",
  "completed_at": "2026-09-04T09:13:01.402000+00:00"
}

{
  "id": "3b7d90e2-5a41-4c8f-b0d6-1e9c72af4415",
  "entity_name": "Example Trading Company",
  "entity_type": "company",
  "status": "completed",
  "search_type": "sanctions_check",
  "ofac_sanctions": "## OFAC Sanctions Findings\n\n**Status:** *Sanctioned*\n\n**Details:**\n- **Matched entity:** EXAMPLE TRADING COMPANY\n- **Authority:** US Treasury OFAC\n- **Evidence URL:** https://sanctionssearch.ofac.treas.gov/\n\n**Source:** *US Treasury OFAC*",
  "sanctions_sources": [
    {
      "source_id": "ofac_sanctions",
      "title": "OFAC Sanctions",
      "authority": "US Treasury OFAC",
      "details": "## OFAC Sanctions Findings ...",
      "hit_count": 1
    },
    {
      "source_id": "eu_sanctions",
      "title": "EU Sanctions",
      "authority": "",
      "details": "## EU Sanctions Findings ...",
      "hit_count": 0
    }
  ],
  "criminal_watchlists": null,
  "pep": null,
  "created_at": "2026-09-04T09:20:03.771000+00:00",
  "completed_at": "2026-09-04T09:20:19.088000+00:00"
}

import os
import time
import requests

BASE = "https://screenveritai.com/api/v1"
HEADERS = {"X-API-Key": os.environ["SCREENVERITAI_API_KEY"]}


def screen(entity_name, entity_type="person", country=""):
    created = requests.post(
        f"{BASE}/search",
        headers=HEADERS,
        json={
            "entity_name": entity_name,
            "entity_type": entity_type,
            "search_type": "sanctions_check",
            "country": country,
        },
        timeout=30,
    )
    created.raise_for_status()          # 401/403/429 raise here
    body = created.json()               # 202 Accepted
    search_id = body["search_id"]
    wait = body["estimated_time_seconds"]

    # estimated_time_seconds is a hint, so keep polling past it.
    deadline = time.time() + max(wait, 60) * 4
    while time.time() < deadline:
        result = requests.get(f"{BASE}/search/{search_id}", headers=HEADERS, timeout=30)
        result.raise_for_status()
        payload = result.json()
        status = payload["status"]
        if status == "completed":
            return payload
        if status.startswith("error"):
            raise RuntimeError(f"search {search_id} ended in {status}")
        time.sleep(3)
    raise TimeoutError(f"search {search_id} still {status}; route to manual review")


result = screen("Test Person", country="PL")
ofac = result["ofac_sanctions"] or ""
sdn_hit = "**Status:** *Sanctioned*" in ofac
# Machine-readable equivalent:
sdn_hit = any(
    source["source_id"] == "ofac_sanctions" and source["hit_count"] > 0
    for source in result["sanctions_sources"]
)
print(result["id"], "OFAC hit" if sdn_hit else "no OFAC listing found")