ScreenVeritAI · API Specv1 · GA · reference
    API za razvojne inženjere

    Zašto prepisivati imena između sustava kad jedan API poziv radi sve?

    Ugradite verifikaciju tvrtki, mapiranje vlasništva, PEP provjeru, negativne medije i sankcijske signale izravno u svoje postojeće 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

    §05Vlastita izrada naspram integracije ScreenVeritAI-a

    p. 05 / 09
    Vrijeme do produkcije
    Vlastita izrada
    6-12 mjeseci za nabavu lista, izgradnju podudaranja, obradu rubnih slučajeva
    ScreenVeritAI API
    Dani za integraciju — spremno za produkciju od prvog API poziva
    Pokrivenost sankcijskih lista
    Vlastita izrada
    Ručno preuzimanje svakog formata liste; stalno održavanje sheme
    ScreenVeritAI API
    Svaki veći izvor, kontinuirano održavan i ažuriran
    Točnost podudaranja
    Vlastita izrada
    Prilagođeno neizravno podudaranje zahtijeva NLP stručnost i stalno podešavanje
    ScreenVeritAI API
    AI s neizravnim podudaranjem, transliteracijom, razrješavanjem pseudonima, fonetičkim algoritmima
    PEP i negativni mediji
    Vlastita izrada
    Zasebni dobavljači, zasebne integracije, zasebni proračuni
    ScreenVeritAI API
    PEP, negativni mediji i UBO podaci u istom API odgovoru
    Tekuće održavanje
    Vlastita izrada
    Poseban tim za ažuriranja lista, promjene sheme, podešavanje lažno pozitivnih rezultata
    ScreenVeritAI API
    Potpuno upravljano — ažuriranja, poboljšanja i infrastrukturu rješavamo umjesto Vas
    Revizijski trag
    Vlastita izrada
    Izgradite vlastitu infrastrukturu za evidenciju, dokaze i čuvanje podataka
    ScreenVeritAI API
    Vremenski označeni paketi dokaza s referencama izvora uključeni

    §06Četiri koraka do ugrađene sukladnosti

    p. 06 / 09
    1

    Zatražite API ključ

    Izradite ključ s definiranim ovlastima iz svoje nadzorne ploče, s pristupom najmanjih potrebnih prava: search:read, search:write, batch:read, batch:write.

    2

    Integrirajte krajnju točku

    Jedan POST poziv u Vaš proces onboardinga, plaćanja ili CRM-a — pošaljite naziv subjekta, vrstu i državu, dobijte identifikator zadatka natrag.

    3

    Obradite rezultate

    Ispitujte krajnju točku rezultata ili primite webhook povratni poziv sa strukturiranim JSON-om — kontekst tvrtke, vlasništvo, PEP, negativni mediji, sankcijski signali i ocjene rizika.

    4

    Pratite i primajte upozorenja

    Konfigurirajte kontinuirano praćenje — API šalje upozorenja kad se sankcijske liste ažuriraju ili se pojave novi negativni mediji.

    §07Počnite unutar nekoliko minuta

    p. 07 / 09

    Jedan API poziv vraća potpun rezultat provjere.

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

    §08Performanse API-ja

    p. 08 / 09

    Svi

    Veći izvori provjereni po API pozivu

    <2 min

    Prosječno vrijeme odgovora za potpunu provjeru s dubinskim istraživanjem

    99,9%

    SLA dostupnosti API-ja za produkcijske integracije

    §09Česta pitanja o API integraciji

    p. 09 / 09
    01Kako autentificiram API zahtjeve?
    Autentificirajte API zahtjeve tajnim ključem proslijeđenim u zaglavlju Authorization. Ključevi se izrađuju u Vašoj nadzornoj ploči s ograničenim, najnužnijim ovlastima.
    02Je li API sinkroni ili asinkroni?
    Asinkroni. Predajte zahtjev, dobijte identifikator zadatka, preuzmite rezultate ispitivanjem statusa ili putem webhooka. Vaš sustav se nikad ne blokira.
    03U kojem formatu API vraća odgovor?
    Strukturirani JSON s podudaranjima sankcija, PEP oznakama, negativnim medijima, stupnjevima pouzdanosti, referencama izvora i klasifikacijom prema razini rizika.
    04Koja ograničenja brzine vrijede?
    Dodjeljuju se prema razini pretplate po API ključu. Zaglavlja odgovora uključuju preostalu kvotu i vrijeme resetiranja.
    05Mogu li provjeravati subjekte skupno putem API-ja?
    Da. Krajnja točka za skupnu obradu prihvaća CSV ili XLSX s do 100 redaka po zahtjevu, a rezultati se mogu preuzeti po retku ili kao potpuni izvoz.
    06Kako postavim kontinuirano praćenje putem API-ja?
    Konfigurirajte praćenje nakon početne provjere. Kad se liste ažuriraju ili se pojave novi negativni mediji, API šalje webhook na Vašu krajnju točku.
    07Koji su podaci o sukladnosti uključeni u svaki rezultat provjere?
    Podudaranja sa sankcijama kroz svaki veći izvor, PEP status s obiteljskim vezama, negativni mediji s višejezičnim citatima, UBO podaci, razina rizika i vremenski označen paket dokaza.
    08Koliko traje provjera?
    Standardna provjera sankcija: nekoliko sekundi. Dubinsko istraživanje s negativnim medijima i mapiranjem vlasništva: manje od dvije minute.
    API terminologija
    REST API
    Web API koji koristi standardne HTTP metode — kompatibilan sa svakim jezikom ili okvirom koji može slati HTTP zahtjeve.
    Webhook
    Server-server HTTP povratni poziv koji se aktivira kad se provjera dovrši ili praćenje otkrije promjenu.
    Asinkrona obrada
    API odmah prihvaća zadatak i obrađuje ga u pozadini — rezultate preuzimate ispitivanjem statusa ili putem webhooka.
    API ključ
    Tajni token za autentifikaciju API zahtjeva, s definiranim ovlastima za pristup s najmanjim potrebnim pravima.
    Ograničenje brzine
    Ograničava broj API zahtjeva po vremenskom prozoru prema razini pretplate — preostala kvota i vrijeme resetiranja nalaze se u zaglavljima odgovora.
    Strukturirani odgovor
    Strojno čitljiv JSON s dosljednim nazivima i vrstama polja, koji omogućuje automatsku obradu i logiku odlučivanja.
    Izvori iz industrije
    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.

    Započnite provjeru u minutama.

    Odaberite plan i počnite provjeravati već danas.