---
title: "Returns OFAC Specially Designated Nationals (SDN) sanctions list entries, republished as-is (not a screening service; verify against treasury.gov)"
method: GET
path: "/v1/ofac-sdn"
---

# Returns OFAC Specially Designated Nationals (SDN) sanctions list entries, republished as-is (not a screening service; verify against treasury.gov)

`GET /v1/ofac-sdn`

## Request

- Base URL: `https://api.keyvex.com`
- URL: `https://api.keyvex.com/v1/ofac-sdn`
- Auth: API key in header `x-api-key`

Returns OFAC Specially Designated Nationals (SDN) sanctions list entries, republished as-is (not a screening service; verify against treasury.gov). Use this for: sanctions-program queries (e.g., 'who's on the Russia SDN list'), or cross-referencing named individuals / entities against the canonical US sanctions list.  Source: US Treasury OFAC — sanctionslistservice.ofac.treas.gov. ~19,000 entries refreshed daily. Each entry represents a person, entity, vessel, or aircraft sanctioned by the US government under one or more programs (CUBA, IRAN, SDGT [terrorism], NPWMD [WMD proliferation], RUSSIA-EO14024, etc.).  US persons (citizens, residents, US-domiciled companies) are legally prohibited from transacting with SDNs — this is the canonical list published by OFAC.  Filter by name substring for primary lookups. entity_type values: 'individual', 'entity', 'vessel', 'aircraft'. Every SDN record carries exactly one of the four — companies are 'entity'. program is a substring filter against the comma-delimited Program field (e.g., 'iran', 'russia', 'narcotics'). remarks substring catches aliases, DOB / passport references, and related-party hints.  Direct ent_num lookup is fastest (OFAC's stable entity number).  WHAT'S NOT IN v1A (data-model limitations to know about): the schema does NOT include designation_date (when OFAC originally added the entry). OFAC's basic SDN.csv source file only provides 12 columns and omits this — the date lives in OFAC's advanced XML and a separate 'Recent Actions' page on their site. So 'sanctions added in the last N days' is not directly queryable via this tool — point users at ofac.treasury.gov/recent-actions for that specific question. v1.1 polish will add advanced-XML ingestion to capture designation_date. Also: there's no since/until filter and no date sort option for the same reason — the only sort options are name and ent_num.  Pure-publisher posture: KeyVex returns OFAC's published list as-is. No derived 'risk score' or 'similarity match' — agents handle fuzzy matching downstream. For broader list coverage, agents should also consult the US Consolidated Screening List (get_screening_list) which spans 12 export-control / sanctions lists from State + Commerce + Treasury.

## Query parameters

- `ent_num` string
- `name` string
- `entity_type` 'individual' | 'entity' | 'vessel' | 'aircraft'
- `program` string
- `remarks` string
- `sort_by` 'ent_num' | 'name'
- `sort_order` 'asc' | 'desc'
- `limit` integer

## Response `200`

JSON envelope: { results: [...], count, has_more }.

## Other responses

- `400`: Invalid parameter.
- `401`: Missing or invalid API key.
- `402`: This tool requires a higher plan (upgrade_required). Retrying will not help.
- `429`: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.

---

[API](https://skmtc.dev/keyvex/apis/keyvex-api.md) · [All operations](https://skmtc.dev/keyvex/apis/keyvex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/keyvex/apis/keyvex-api/revisions/01c0210c19cd?raw)