# Sankčné zoznamy

> Kontrola firiem a osôb voči konsolidovanému sankčnému zoznamu Európskej únie a americkému OFAC SDN cez REST API.

Konsolidovaný sankčný zoznam Európskej únie obsahuje osoby a subjekty, voči ktorým platia reštriktívne opatrenia. Spolu s americkým zoznamom OFAC SDN tvorí základ sankčného skríningu.

## Čo register obsahuje
- Zhoda mena subjektu alebo osoby so sankčným zoznamom
- Miera zhody, aby sa dala odlíšiť istá zhoda od podobnosti mien
- Program, v rámci ktorého boli sankcie uložené
- Dátum zaradenia na zoznam

## Polia, ktoré vraciame

| Pole | Význam |
| --- | --- |
| `total_hits` | Celkový počet zhôd naprieč oboma zoznamami. |
| `eu_fsf_hits` | Pole zhôd s konsolidovaným sankčným zoznamom EÚ. |
| `ofac_hits` | Pole zhôd so zoznamami OFAC. |
| `whole_name` | Meno zo sankčného zoznamu, na ktoré zhoda padla. |
| `score` | Miera zhody mena v rozsahu 0 až 1. |
| `regulation_ref` | Odkaz na predpis, ktorým bola sankcia uložená. |
| `external_id` | Identifikátor záznamu v zdrojovom zozname. |

## Ako si dáta vyžiadate

```http
GET /v1/company/ico/51636549?scope=sanctions

{
  "sanctions": {
    "eu_fsf_hits": [],
    "ofac_hits": [],
    "total_hits": 0
  }
}
```

## Ako často aktualizujeme

Denne, obidva zoznamy samostatne. Sankčné zoznamy sa menia nepravidelne a zmena môže nastať zo dňa na deň, preto ich sťahujeme každú noc.

## Na čo sa to používa

Sankčný skríning je povinnou súčasťou AML procesov vo finančnom sektore a čoraz častejšie aj bežnou súčasťou onboardingu obchodných partnerov.

Cez webhook sanctions.match dostanete upozornenie, ak sa na zoznam dostane subjekt, ktorého už máte v databáze – čo je situácia, ktorú periodická kontrola raz za štvrťrok zachytí neskoro.

## Časté otázky

### Prečo vraciate mieru zhody a nie len áno alebo nie?

Prepisy mien z cyriliky a arabčiny sa v zoznamoch líšia, takže presná zhoda na znak by prehliadla skutočné zásahy. Miera zhody vám dovolí nastaviť si vlastný prah a hraničné prípady posúdiť ručne.

### Kontrolujete aj fyzické osoby?

Áno. Sankčné zoznamy obsahujú osoby aj subjekty a skríning zahŕňa štatutárov a konečných užívateľov výhod, ak sú k firme známi.