# Treasury OFAC API: Check sanctions

> Screens a name against the OFAC SDN and non-SDN sanctions lists. Returns scored entries with identifying details. Similar names are potential matches, not confirmed identities.

Unofficial. Not affiliated with or endorsed by Treasury OFAC.

- Page: https://fous.com/methods/sanctionssearch.ofac.treas.gov/check-sanctions
- Method: `sanctionssearch.ofac.treas.gov/check_sanctions`, version 1
- Website: sanctionssearch.ofac.treas.gov
- Returns: match flag, summary, entries with list, programs, addresses, aliases, birth/registration date, score, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `name` | string | yes | `"Mahan Air"` | Person, company, vessel or aircraft name to screen, for example Viktor Vekselberg. |
| `type` | string | no | `"company"` | Kind of name, for example company. One of "any", "person", "company", "vessel", "aircraft". Default "any". |
| `country` | string | no | `"Iran"` | Country to filter by, for example Iran. |
| `strictness` | string | no | `"strict"` | Minimum OFAC name score: strict 100%, balanced 90%, or broad 80%. One of "strict", "balanced", "broad". Default "balanced". |
| `max_results` | integer | no | `5` | Maximum number of entries to return, for example 25. Default 25. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "name": "Mahan Air",
  "type": "company",
  "country": "Iran",
  "strictness": "strict",
  "max_results": 5
}
```

Its output:

```json
{
  "matches": [
    {
      "list": "SDN",
      "name": "MAHAN AIR",
      "type": "Company",
      "aliases": [
        "MAHAN AIR CO."
      ],
      "addresses": [
        "No. 21, Mahan Air Tower, Tehran, Tehran, 1481655761, Iran; Azadegan Street, Jenah Expressway, Beginning of Sheykh Fazlollah Exp. Way; First of Karaj High Way",
        "Mahan Air Tower, 21st Floor, Tehran, Tehran, Iran; Azadeghan Street, Karaj Highway; P.O. Box 14515-411",
        "Mahan Air Tower, Tehran, Tehran, 1481655761, Iran; Azadegan St., Karaj Highway; P.O. Box 411-14515"
      ],
      "entry_link": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=12927",
      "match_score": 100,
      "nationality": null,
      "ofac_entry_id": "12927",
      "program_codes": [
        "NPWMD",
        "IFSR",
        "SDGT"
      ],
      "sanctions_programs": [
        "Non-Proliferation",
        "Iran-related",
        "Terrorism"
      ],
      "date_of_birth_or_registration": null
    }
  ],
  "summary": "1 possible OFAC sanctions match found, searched 2026-10-23. Verify identities before taking action.",
  "match_found": true
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"sanctionssearch.ofac.treas.gov/check_sanctions","input":{"name":"Mahan Air","type":"company","country":"Iran","strictness":"strict","max_results":5}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Screen the name Viktor Vekselberg against the OFAC sanctions lists and show any scored matches with their programs and aliases
- Is there any sanctions hit for a shipping company called Aurora Maritime Holdings registered in Panama?
- Check whether the vessel named Sea Falcon appears on any US Treasury sanctions list, using a broad matching threshold
- Run a balanced sanctions screen on the individual Mohammad Reza Karimi from Iran and return up to 10 entries
- Look up any strict-match OFAC entries for an aircraft called Silver Wing and list their registration details

## Input schema

```json
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Person, company, vessel or aircraft name to screen, for example Viktor Vekselberg."
    },
    "type": {
      "enum": [
        "any",
        "person",
        "company",
        "vessel",
        "aircraft"
      ],
      "type": "string",
      "default": "any",
      "description": "Kind of name, for example company."
    },
    "country": {
      "type": "string",
      "description": "Country to filter by, for example Iran."
    },
    "strictness": {
      "enum": [
        "strict",
        "balanced",
        "broad"
      ],
      "type": "string",
      "default": "balanced",
      "description": "Minimum OFAC name score: strict 100%, balanced 90%, or broad 80%."
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of entries to return, for example 25."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "match_found",
    "summary",
    "matches"
  ],
  "properties": {
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "list": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "entry_link": {
            "type": "string"
          },
          "match_score": {
            "type": "integer"
          },
          "nationality": {
            "type": [
              "string",
              "null"
            ]
          },
          "ofac_entry_id": {
            "type": "string"
          },
          "program_codes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sanctions_programs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "date_of_birth_or_registration": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "summary": {
      "type": "string"
    },
    "match_found": {
      "type": "boolean"
    }
  }
}
```

## See more

- [EU Sanctions Map API: Check name against EU sanctions](https://fous.com/methods/sanctionsmap.eu/check-sanctions.md): Checks a person or organisation name against the EU consolidated financial sanctions list (asset freezes) on the EU Sanctions Map, returning likely matches with their regime, aliases, listing details and linked legal act. Name similarity is a screening aid, not identity confirmation.
- [GOV.UK API: Check a name against the UK Sanctions List](https://fous.com/methods/gov.uk/check-sanctions.md): Checks a name against the current UK Sanctions List and returns possible matches in the site's best-match order, with designation details. Results may include entries that only mention the name in their reasons, so check each entry before identifying anyone.
- [United Nations API: Check sanctions](https://fous.com/methods/scsanctions.un.org/check-sanctions.md): Checks a person or organisation name against the current UN Security Council Consolidated List and returns ranked possible matches.
- [EU Sanctions Map API: Get country sanctions](https://fous.com/methods/sanctionsmap.eu/get-country-sanctions.md): Lists EU Sanctions Map regimes concerning a country, with measures, EUR-Lex legal acts, amendment dates and listed person and entity counts.
- [USPTO API: Search US trademarks](https://fous.com/methods/uspto.gov/search-trademarks.md): Finds US trademark filings matching a brand name, optionally limited to likely goods or service classes. Exact marks come first, similar marks follow; not a legal clearance opinion.
- [USAspending API: Get company federal awards](https://fous.com/methods/usaspending.gov/get-company-federal-awards.md): Returns federal obligations and distinct awards for a company or organization, including its parent and child recipient records. Covers the selected fiscal year or the last five fiscal years.
- [FEC API: Get candidate fundraising](https://fous.com/methods/fec.gov/get-candidate-fundraising.md): Gets a federal candidate's fundraising and spending for a two-year FEC cycle. If several names match, returns the match with the most reported receipts.
- [FBI API: List most wanted notices](https://fous.com/methods/fbi.gov/list-most-wanted.md): Lists FBI wanted, missing-person and seeking-information notices, newest first, filtered by category, field office or name.
