ScreenVeritAI · API Specv1 · GA · reference
    API za razvijalce

    Zakaj kopirati imena med sistemi, ko en klic API opravi vse?

    Vgradite potrjevanje podjetij, mapiranje lastništva, preverjanje PEP, negativne medije in sankcijske signale neposredno v obstoječe delovne procese.

    §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

    §05Gradnja lastne rešitve proti integraciji ScreenVeritAI

    p. 05 / 09
    Čas do produkcije
    Gradnja lastne rešitve
    6–12 mesecev za pridobitev seznamov, gradnjo ujemanja in obravnavo posebnih primerov
    API ScreenVeritAI
    Dnevi do integracije — pripravljeno za produkcijo že od prvega klica API
    Pokritost seznamov sankcij
    Gradnja lastne rešitve
    Ročno vnašanje vsake oblike seznama; stalno vzdrževanje sheme
    API ScreenVeritAI
    Vsak večji vir, stalno vzdrževan in posodabljan
    Natančnost ujemanja
    Gradnja lastne rešitve
    Lastno približno ujemanje zahteva strokovnost NLP in stalno prilagajanje
    API ScreenVeritAI
    UI s približnim ujemanjem, transliteracijo, razreševanjem vzdevkov in fonetičnimi algoritmi
    PEP in negativni mediji
    Gradnja lastne rešitve
    Ločeni ponudniki, ločene integracije, ločeni proračuni
    API ScreenVeritAI
    Podatki PEP, negativnih medijev in UBO v istem odgovoru API
    Stalno vzdrževanje
    Gradnja lastne rešitve
    Namenska ekipa za posodobitve seznamov, spremembe sheme, prilagajanje lažno pozitivnih zadetkov
    API ScreenVeritAI
    Popolnoma upravljano — posodobitve, izboljšave in infrastruktura poskrbljene za vas
    Revizijska sled
    Gradnja lastne rešitve
    Zgradite lastno infrastrukturo za beleženje, dokaze in hranjenje
    API ScreenVeritAI
    Dokazni paketi s časovnim žigom, ki vključujejo navedbo virov

    §06Štirje koraki do vgrajene skladnosti

    p. 06 / 09
    1

    Pridobite svoj API ključ

    V nadzorni plošči ustvarite ključ z opredeljenim obsegom pravic z najmanjšimi potrebnimi pravicami: search:read, search:write, batch:read, batch:write.

    2

    Vključite endpoint

    En klic POST v vaš proces sprejema strank, plačil ali CRM — pošljite ime subjekta, vrsto in državo, prejmete identifikator opravila.

    3

    Obdelajte rezultate

    Anketirajte endpoint za rezultate ali prejmite povratni klic webhook s strukturiranim JSON — kontekst podjetja, lastništvo, PEP, negativni mediji, sankcijski signali in ocene tveganja.

    4

    Spremljajte in opozarjajte

    Nastavite stalno spremljanje — API pošlje opozorila, ko se seznami sankcij posodobijo ali se pojavijo novi negativni mediji.

    §07Začnite v nekaj minutah

    p. 07 / 09

    En sam klic API vrne popoln rezultat preverjanja.

    Preverite 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"}'
    Preverite rezultat
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08Zmogljivost API

    p. 08 / 09

    Vsi

    Glavni viri, preverjeni na klic API

    <2 min

    Povprečen odzivni čas za polno preverjanje s poglobljeno raziskavo

    99,9 %

    Zajamčena razpoložljivost API za produkcijske integracije

    §09Pogosta vprašanja o integraciji API

    p. 09 / 09
    01Kako avtenticiram zahtevke API?
    Zahtevke API avtenticirajte s skrivnim ključem, posredovanim v glavi Authorization. Ključi se ustvarijo v vaši nadzorni plošči z omejenimi pravicami po načelu najmanjših potrebnih privilegijev.
    02Ali je API sinhron ali asinhron?
    Asinhron. Oddate zahtevo, prejmete identifikator opravila, rezultate pridobite z anketiranjem ali prek webhook. Vaš proces se nikoli ne blokira.
    03V kakšni obliki API vrne odgovor?
    Strukturiran JSON z zadetki sankcij, oznakami PEP, negativnimi mediji, stopnjami zaupanja, navedbo virov in razvrstitvijo po ravni tveganja.
    04Katere omejitve hitrosti veljajo?
    Dodeljene glede na paket naročnine za vsak API ključ. Glave odgovora vključujejo preostalo kvoto in čas ponastavitve.
    05Ali lahko subjekte preverjam paketno prek API?
    Da. Endpoint za pakete sprejme CSV ali XLSX z do 100 vrsticami na zahtevek, rezultate pa pridobite po vrstici ali kot celoten izvoz.
    06Kako nastavim stalno spremljanje prek API?
    Spremljanje nastavite po prvotnem preverjanju. Ko se seznami posodobijo ali se pojavijo novi negativni mediji, API pošlje webhook na vaš endpoint.
    07Kateri podatki o skladnosti so vključeni v vsak rezultat preverjanja?
    Zadetki sankcij v vsakem večjem viru, status PEP z družinskimi povezavami, negativni mediji z večjezičnimi navedbami, podatki UBO, raven tveganja in dokazni paket s časovnim žigom.
    08Koliko časa traja preverjanje?
    Standardno preverjanje sankcij: nekaj sekund. Poglobljena raziskava z negativnimi mediji in mapiranjem lastništva: manj kot dve minuti.
    Terminologija API
    REST API
    Spletni API, ki uporablja standardne metode HTTP — združljiv s katerim koli jezikom ali ogrodjem, ki lahko izvaja zahtevke HTTP.
    Webhook
    Povratni klic HTTP med strežniki, sprožen, ko se preverjanje zaključi ali spremljanje zazna spremembo.
    Asinhrona obdelava
    API takoj sprejme opravilo in ga obdela v ozadju — rezultate pridobite z anketiranjem ali prek webhook.
    API ključ
    Skrivni žeton za avtentikacijo zahtevkov API, z opredeljenim obsegom pravic za dostop z najmanjšimi potrebnimi pravicami.
    Omejevanje hitrosti
    Omeji zahtevke API na časovno okno glede na paket naročnine — preostala kvota in čas ponastavitve v glavah odgovora.
    Strukturiran odgovor
    Strojno berljiv JSON z doslednimi imeni in vrstami polj, ki omogoča samodejno razčlenjevanje in logiko odločanja.
    Panožni viri
    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 preverjanje v nekaj minutah.

    Izberite paket in še danes začnite s preverjanjem.