ScreenVeritAI · API Specv1 · GA · reference
    Vývojárske API

    Prečo prepisovať mená medzi systémami, keď to zvládne jedno volanie API?

    Zabudujte overenie firiem, mapovanie vlastníctva, kontrolu PEP, negatívne médiá a sankčné signály priamo do svojich existujúcich procesov.

    §01The request

    p. 01 / 09

    One POST call. That's your entire integration.

    Entity name, country, screening profile. Send it. The AI agent takes it from there — no orchestration logic on your end.

    nameEntity name, alias-aware
    countryISO 3166-1 alpha-2 country code
    profile"sanctions_check" or "full_search"
    POST /v1/screen
    bash
    1curl -X POST https://api.screenveritai.com/v1/screen \
    2 -H 'Authorization: Bearer YOUR_API_KEY' \
    3 -H 'Content-Type: application/json' \
    4 -d '{
    5 "name": "Acme Trading LLC",
    6 "country": "AE",
    7 "profile": "full_search"
    8 }'

    §02The response

    p. 02 / 09
    POST /api/v1/screen — response
    200 OK
    1{
    2"entity": "Acme Trading LLC",
    3"request_id": "srv_a8f3c1d9",
    4"processed_at": "2026-03-26T09:14:02Z",
    5"sanctions": {
    6"status": "clear",
    7"lists_checked": 10,
    8"matches": []
    9},
    10"pep": {
    11"status": "match",
    12"details": "Board member linked to PEP (gov. minister spouse)"
    13},
    14"adverse_media": {
    15"hits": 3,
    16"languages": ["en", "ar", "ko"],
    17"highest_severity": "medium"
    18},
    19"ubo": {
    20"layers_traced": 3,
    21"flagged": true,
    22"reason": "UBO connected to sanctioned entity"
    23},
    24"risk_tier": "enhanced_due_diligence"
    25}
    Clear / pass
    Match / flagged
    Hits / warnings
    Counts / metadata

    Structured JSON. Every risk vector.

    Sanctions status, PEP matches, adverse media hits, UBO flags, and risk tier — all in one response, ready for your decision engine.

    "sanctions"Direct list match status + count
    "pep"PEP match + relationship detail
    "adverse_media"Hit count, languages, severity
    "ubo"Layers traced + flagged indicator
    "risk_tier"Normalized risk classification

    §03API reference

    p. 03 / 09

    Three endpoints cover all screening workflows.

    API reference — endpoints
    v1 · rest
    POST
    /v1/screen

    Submit an entity for sanctions, PEP, adverse media, and UBO screening.

    Request

    curl -X POST https://api.screenveritai.com/v1/screen \
    -H 'Authorization: Bearer {API_KEY}' \
    -d '{"name": "Acme LLC", "country": "AE", "profile": "full_search"}'

    Response

    200 OK
    { "request_id": "srv_a8f3c1d9", "status": "queued",
    "estimated_seconds": 30, "poll_url": "/v1/result/srv_a8f3c1d9" }

    §04Integration patterns

    p. 04 / 09

    The API sits between data entry and decision — wherever you need a risk signal.

    Customer onboarding
    Customer signupPOST /v1/screenDecision engineApprove / reject
    Payment processing
    Transaction initGET /v1/checkScreen counterpartyRelease / hold
    CRM re-trigger
    Record updatedWebhook firesPOST /v1/screenAlert if changed

    §05Vlastný vývoj vs. integrácia ScreenVeritAI

    p. 05 / 09
    Čas do produkcie
    Vlastný vývoj
    6 – 12 mesiacov na získanie zoznamov, vybudovanie porovnávania, riešenie hraničných prípadov
    API ScreenVeritAI
    Dni na integráciu — pripravené na produkciu od prvého volania API
    Pokrytie sankčných zoznamov
    Vlastný vývoj
    Ručné zapracovanie formátu každého zoznamu; priebežná údržba schém
    API ScreenVeritAI
    Každý väčší zdroj, priebežne udržiavaný a aktualizovaný
    Presnosť porovnávania
    Vlastný vývoj
    Vlastný fuzzy matching vyžaduje NLP odbornosť a neustále ladenie
    API ScreenVeritAI
    AI s fuzzy matchingom, transliteráciou, rozpoznávaním aliasov a fonetickými algoritmami
    PEP a negatívne médiá
    Vlastný vývoj
    Samostatní dodávatelia, samostatné integrácie, samostatné rozpočty
    API ScreenVeritAI
    Dáta PEP, negatívnych médií a UBO v tej istej odpovedi API
    Priebežná údržba
    Vlastný vývoj
    Vyhradený tím na aktualizácie zoznamov, zmeny schém, ladenie falošne pozitívnych výsledkov
    API ScreenVeritAI
    Plne spravované — aktualizácie, vylepšenia aj infraštruktúru riešime za vás
    Auditná stopa
    Vlastný vývoj
    Vybudujte si vlastnú infraštruktúru logovania, dôkazov a uchovávania záznamov
    API ScreenVeritAI
    Časovo opečiatkované balíky dôkazov s odkazmi na zdroje zahrnuté od začiatku

    §06Štyri kroky k vstavanému compliance

    p. 06 / 09
    1

    Získajte svoj API kľúč

    Vytvorte si na nástenke kľúč s obmedzeným rozsahom oprávnení podľa princípu najmenších práv: search:read, search:write, batch:read, batch:write.

    2

    Integrujte endpoint

    Jedno volanie POST z vášho onboardingového, platobného alebo CRM procesu — pošlete meno subjektu, typ a krajinu, dostanete späť ID úlohy.

    3

    Spracujte výsledky

    Vyzdvihnite si výsledky pollingom endpointu alebo prijmite webhook so štruktúrovaným JSON — kontext firmy, vlastníctvo, PEP, negatívne médiá, sankčné signály a rizikové skóre.

    4

    Monitorujte a upozorňujte

    Nastavte priebežný monitoring — API pošle upozornenie, keď sa aktualizujú sankčné zoznamy alebo sa objavia nové negatívne médiá.

    §07Začnite za pár minút

    p. 07 / 09

    Jedno volanie API vráti kompletný výsledok screeningu.

    Preverte subjekt
    bash
    curl -X POST https://api.screenveritai.com/v1/screen \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      -H 'Content-Type: application/json' \
      -d '{"name": "Acme Trading LLC", "country": "AE"}'
    Skontrolujte výsledok
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08Výkon API

    p. 08 / 09

    Všetky

    Hlavné zdroje preverené pri každom volaní API

    <2 min

    Priemerný čas odpovede pri kompletnom screeningu s Deep Research

    99,9 %

    SLA dostupnosti API pre produkčné integrácie

    §09Časté otázky k integrácii API

    p. 09 / 09
    01Ako autentifikujem požiadavky API?
    Autentifikujte API požiadavky tajným kľúčom odovzdaným v hlavičke Authorization. Kľúče sa vytvárajú na vašej nástenke s obmedzeným rozsahom oprávnení.
    02Je API synchrónne alebo asynchrónne?
    Asynchrónne. Odošlete požiadavku, dostanete ID úlohy, výsledky si vyzdvihnete pollingom alebo cez webhook. Váš proces sa nikdy neblokuje.
    03Aký formát odpovede API vracia?
    Štruktúrovaný JSON so sankčnými zhodami, príznakmi PEP, negatívnymi médiami, skóre spoľahlivosti, odkazmi na zdroje a klasifikáciou rizikovej úrovne.
    04Aké limity požiadaviek platia?
    Priradené podľa úrovne predplatného pre každý API kľúč. Hlavičky odpovede obsahujú zostávajúcu kvótu a čas resetu.
    05Môžem preveriť subjekty hromadne cez API?
    Áno. Endpoint pre hromadné spracovanie prijíma CSV alebo XLSX s max. 100 riadkami na požiadavku, výsledky sú dostupné po riadkoch alebo ako kompletný export.
    06Ako nastavím priebežný monitoring cez API?
    Monitoring nastavíte po úvodnom screeningu. Keď sa aktualizujú zoznamy alebo sa objavia nové negatívne médiá, API pošle webhook na váš endpoint.
    07Aké compliance dáta sú súčasťou každého výsledku screeningu?
    Sankčné zhody naprieč každým väčším zdrojom, PEP status s rodinnými väzbami, negatívne médiá s viacjazyčnými citáciami, dáta UBO, riziková úroveň a časovo opečiatkovaný balík dôkazov.
    08Ako dlho trvá screening?
    Štandardná sankčná kontrola: sekundy. Deep Research s negatívnymi médiami a mapovaním vlastníctva: menej ako dve minúty.
    Terminológia API
    REST API
    Webové API využívajúce štandardné HTTP metódy — kompatibilné s ľubovoľným jazykom alebo frameworkom, ktorý dokáže vykonávať HTTP požiadavky.
    Webhook
    HTTP volanie zo servera na server, spustené po dokončení screeningu alebo po zistení zmeny monitoringom.
    Asynchrónne spracovanie
    API prijme úlohu okamžite a spracuje ju na pozadí — výsledky získate pollingom alebo cez webhook.
    API kľúč
    Tajný token na autentifikáciu požiadaviek API, s obmedzeným rozsahom oprávnení podľa princípu najmenších práv.
    Obmedzenie počtu požiadaviek (rate limiting)
    Obmedzuje počet požiadaviek API za časové okno podľa úrovne predplatného — zostávajúca kvóta a čas resetu sú v hlavičkách odpovede.
    Štruktúrovaná odpoveď
    Strojovo čitateľný JSON s konzistentnými názvami a typmi polí, ktorý umožňuje automatizované spracovanie a rozhodovaciu logiku.
    Odborové zdroje
    1. 01
    2. 02
      Regulatory Technology for AML/CFT Compliance

      Bank for International Settlements — FSI Insights

    3. 03
      OFAC Compliance Commitments Framework

      U.S. Department of the Treasury

    4. 04
      EU Anti-Money Laundering Authority (AMLA) Regulation

      Official Journal of the European Union

    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    Začnite screening za pár minút.

    Vyberte si plán a začnite preverovať už dnes.