ScreenVeritAI
    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.

    Získať API kľúčZobraziť cenník

    The request

    p. 01 / 09

    One POST call, then your poll loop.

    Entity name, type, country, screening type. The call returns 202 with a search_id and an ETA, and the agent works in the background — you poll for the result rather than hold the connection open.

    entity_nameRequired, 1-500 characters. Alias-aware matching
    entity_type"person", "company" or "any" (default "any")
    countryOptional jurisdiction hint that sharpens identity resolution
    search_type"sanctions_check", "adverse_media" or "full_search"
    POST /api/v1/search
    bash
    1curl -X POST https://screenveritai.com/api/v1/search \
    2 -H 'X-API-Key: YOUR_API_KEY' \
    3 -H 'Content-Type: application/json' \
    4 -d '{
    5 "entity_name": "Acme Trading LLC",
    6 "entity_type": "company",
    7 "country": "AE",
    8 "search_type": "sanctions_check"
    9 }'
    10# 202 Accepted
    11# { "search_id": "SEARCH_ID", "status": "processing",
    12# "estimated_time_seconds": 15 }

    The response

    p. 02 / 09
    GET /api/v1/search/{search_id} — response
    200 OK
    1{
    2"id": "SEARCH_ID",
    3"entity_name": "Acme Trading LLC",
    4"entity_type": "company",
    5"status": "completed",
    6"search_type": "sanctions_check",
    7"ofac_sanctions": "## OFAC Sanctions Findings\n\n
    8**Status:** *Sanctioned*\n\n**Details:**\n
    9- **Matched entity:** ACME TRADING LLC\n
    10- **Authority:** US Treasury OFAC\n...",
    11"eu_sanctions": "## EU Sanctions Findings\n\n
    12**Status:** *No relevant listing found*\n...",
    13"sanctions_sources": [
    14{ "source_id": "ofac_sanctions", "title": "OFAC Sanctions",
    15"authority": "US Treasury OFAC", "hit_count": 1 },
    16{ "source_id": "eu_sanctions", "title": "EU Sanctions",
    17"authority": "", "hit_count": 0 }
    18],
    19"criminal_watchlists": null,
    20"pep": null,
    21"news_summary": null,
    22"final_report": null,
    23"created_at": "2026-09-04T09:20:03.771000+00:00",
    24"completed_at": "2026-09-04T09:20:19.088000+00:00"
    25}
    No relevant listing found / null
    Sanctioned / potential match
    Per-source hit_count
    Status and search_type

    Structured JSON. Findings, not a score.

    One field per sanctions source, plus criminal watchlists and PEP. Each finding is markdown carrying the status line, the matched entity, the authority and an evidence URL — there is no numeric score and no risk tier, because a number hides the line an auditor asks to see.

    "ofac_sanctions"One markdown field per jurisdiction; read the *Status:* line
    "sanctions_sources"source_id, title, authority, details, hit_count per source
    "criminal_watchlists"Markdown when matched, null when nothing matched
    "pep"Markdown when matched, null when nothing matched
    "news_summary"Adverse-media report on adverse_media and full_search
    "status"completed when done; error_* on failure

    API reference

    p. 03 / 09

    Three calls cover a screening integration: queue it, poll it, or hand over a file.

    API reference — endpoints
    v1 · rest
    POST
    /api/v1/search

    Queue a screening run. Returns immediately with a search_id; the work happens in the background.

    Request

    curl -X POST https://screenveritai.com/api/v1/search \
    -H 'X-API-Key: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{"entity_name": "Acme Trading LLC", "entity_type": "company",
    "country": "AE", "search_type": "sanctions_check"}'

    Response

    202 Accepted
    { "search_id": "SEARCH_ID", "status": "processing",
    "message": "Search queued successfully. Poll the GET endpoint for results.",
    "estimated_time_seconds": 15 }

    Integration patterns

    p. 04 / 09

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

    Customer onboarding
    Customer signupPOST /api/v1/searchPoll until completedApprove / hold
    Payment processing
    Transaction initPOST /api/v1/searchPoll until completedRelease / hold
    CRM re-screen
    Record updatedYour scheduler firesPOST /api/v1/searchWrite result back

    Vlastný 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

    Š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 ako štruktúrovaný 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á.

    Zač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://screenveritai.com/api/v1/search \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"entity_name": "Acme Trading LLC", "country": "AE", "search_type": "sanctions_check"}'

# 202 Accepted
# { "search_id": "SEARCH_ID", "status": "processing", "estimated_time_seconds": 15 }
    Skontrolujte výsledok
    bash
    curl https://screenveritai.com/api/v1/search/SEARCH_ID \
  -H 'X-API-Key: YOUR_API_KEY'

# 200 OK
# { "id": "SEARCH_ID", "status": "completed",
#   "ofac_sanctions": "## OFAC Sanctions Findings ... *No relevant listing found* ...",
#   "criminal_watchlists": null, "pep": null }

    Výkon API

    p. 08 / 09

    €0.39

    Quick Check za jedno volanie, bez poplatku za platformu

    202

    HTTP stav po prijatí vyhľadávania; výsledok sa potom dopytuje

    EU

    Hostované vo Fínsku; dáta v pokoji zostávajú v EÚ

    Č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 X-API-Key. 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. 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á, monitoring označí zmenu a upozorní vás v aplikácii.
    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.
    Asynchrónne spracovanie
    API úlohu okamžite prijme a spracuje ju na pozadí — výsledky si vyzdvihnete pollingom.
    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

    Zistite viac

    Screening sankcií

    Preverte subjekty naprieč každým väčším zdrojom s fuzzy matching a dôkazmi na úrovni pre regulátora.

    Screening klientov a hĺbková kontrola

    Zmapujte vlastníctvo, PEP expozíciu, negatívne médiá a sankčné signály pre kompletný rizikový profil protistrany.

    Hromadný screening

    Nahrajte CSV alebo XLSX a overte stovky klientov alebo dodávateľov v jednej úlohe.

    Pokrytie sankčných zoznamov

    Pozrite si každý sankčný zoznam, databázu PEP a jurisdikciu, ktorú ScreenVeritAI pokrýva.

    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.

    Zobraziť cenník