Sanctions Lists

Get available sanctions lists and their metadata.

Endpoint: GET /v1/lists

---

Request

Headers

Header	Required	Description
x-api-key	Yes	Your API key

---

Example Request

curl "https://api.sanctionswise.orchestraprime.ai/v1/lists" \
  -H "x-api-key: YOUR_API_KEY"

---

Response

{
  "lists": [
    {
      "list_id": "ofac_sdn",
      "name": "OFAC Specially Designated Nationals",
      "authority": "US Treasury OFAC",
      "entity_count": 12000,
      "last_updated": "2025-12-10T17:26:38Z",
      "update_frequency": "real-time"
    },
    {
      "list_id": "ofac_consolidated",
      "name": "OFAC Consolidated Sanctions List",
      "authority": "US Treasury OFAC",
      "entity_count": 14500,
      "last_updated": "2025-12-10T00:00:00Z",
      "update_frequency": "daily"
    },
    {
      "list_id": "ofac_fse",
      "name": "OFAC Foreign Sanctions Evaders",
      "authority": "US Treasury OFAC",
      "entity_count": 500,
      "last_updated": "2025-12-10T12:00:00Z",
      "update_frequency": "real-time"
    },
    {
      "list_id": "ofac_ssi",
      "name": "OFAC Sectoral Sanctions Identifications",
      "authority": "US Treasury OFAC",
      "entity_count": 1500,
      "last_updated": "2025-12-10T12:00:00Z",
      "update_frequency": "real-time"
    },
    {
      "list_id": "bis_dpl",
      "name": "BIS Denied Persons List",
      "authority": "US Commerce Department",
      "entity_count": 500,
      "last_updated": "2025-12-09T00:00:00Z",
      "update_frequency": "weekly"
    }
  ]
}

---

Response Fields

List Object

Field	Type	Description
list_id	string	Unique list identifier (use in screening)
name	string	Human-readable list name
authority	string	Government authority
entity_count	number	Approximate entity count
last_updated	string	ISO 8601 timestamp of last update
update_frequency	string	How often the list is updated

---

Supported Lists

List ID	Name	Authority	Update Frequency
ofac_sdn	Specially Designated Nationals	US Treasury OFAC	Real-time
ofac_consolidated	Consolidated Sanctions List	US Treasury OFAC	Daily
ofac_fse	Foreign Sanctions Evaders	US Treasury OFAC	Real-time
ofac_ssi	Sectoral Sanctions Identifications	US Treasury OFAC	Real-time
bis_dpl	Denied Persons List	US Commerce BIS	Weekly

---

Specifying Lists in Screening

When screening, specify which lists to check:

curl -X POST "https://api.sanctionswise.orchestraprime.ai/v1/screen/entity" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "lists": ["ofac_sdn", "ofac_consolidated", "bis_dpl"]
  }'

Default Behavior

If lists is not specified, screening defaults to ["ofac_sdn"].

---

Health Check

Check service status:

curl "https://api.sanctionswise.orchestraprime.ai/v1/health" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "status": "healthy",
  "environment": "production",
  "version": "1.0.0",
  "matching_algorithms": ["exact", "fuzzy", "phonetic", "semantic", "identifier"],
  "endpoints": {
    "/v1/screen/entity": {"methods": ["POST"], "description": "Screen single entity"},
    "/v1/screen/batch": {"methods": ["POST"], "description": "Screen batch (up to 100)"}
  },
  "timestamp": "2025-12-10T19:00:00Z"
}