# searchEuSanctions

**Identifier:** `eusanctions_searchEuSanctions`

**Provider:** [EU Sanctions](https://kirha.com/providers/eusanctions.md)

Screen a person, company or organisation name against the EU consolidated list of financial sanctions (asset freezes), matching every alias and transliteration. Use it for sanctions screening and KYC in the EU, or to list who is designated under a sanctions programme.

## Run it with the CLI

```bash
kirha tools run eusanctions_searchEuSanctions \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "eusanctions_searchEuSanctions",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "description": "Name or part of a name, in any script",
      "minLength": 2,
      "type": "string"
    },
    "programme": {
      "description": "Programme code, e.g., UKR, IRN, BLR, SYR, PRK, TERR",
      "maxLength": 6,
      "minLength": 2,
      "type": "string"
    },
    "type": {
      "enum": [
        "person",
        "entity"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "listGeneratedOn": {
      "type": "string"
    },
    "listed": {
      "type": "boolean"
    },
    "matches": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "aliasCount": {
            "type": "number"
          },
          "birthDate": {
            "type": "string"
          },
          "citizenships": {
            "type": "string"
          },
          "designatedOn": {
            "type": "string"
          },
          "euReference": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "matchQuality": {
            "enum": [
              "exact",
              "all words",
              "partial words",
              "similar spelling",
              "listed"
            ],
            "type": "string"
          },
          "matchedAlias": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "programme": {
            "type": "string"
          },
          "programmeName": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "type": {
            "enum": [
              "person",
              "entity"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "euReference",
          "type",
          "matchQuality",
          "aliasCount",
          "programme"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "listed",
    "total",
    "matches"
  ],
  "type": "object"
}
```

## Related tools

Other EU Sanctions tools that this tool refers to, or that refer to it.

- [`getEuSanctionedParty`](https://kirha.com/providers/eusanctions/getEuSanctionedParty.md)
- [`listEuSanctionsProgrammes`](https://kirha.com/providers/eusanctions/listEuSanctionsProgrammes.md)

-----

[All EU Sanctions tools](https://kirha.com/providers/eusanctions.md) · [< Back to tools list](https://kirha.com/tools.md)