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

    Zatražite API ključPogledajte cijene

    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

    Vlastita 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

    Č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 za strukturirani JSON — 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.

    Počnite unutar nekoliko minuta

    p. 07 / 09

    Jedan API poziv vraća potpun rezultat provjere.

    Provjerite 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 }
    Provjerite rezultat
    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 }

    Performanse API-ja

    p. 08 / 09

    €0.39

    Quick Check po pozivu, bez naknade za platformu

    202

    HTTP status kada je pretraga prihvaćena; rezultat se zatim dohvaća

    EU

    Hostano u Finskoj; podaci u mirovanju ostaju u EU

    Česta pitanja o API integraciji

    p. 09 / 09
    01Kako autentificiram API zahtjeve?
    Autentificirajte API zahtjeve tajnim ključem proslijeđenim u zaglavlju X-API-Key. 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. 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, praćenje označava promjenu i upozorava Vas u aplikaciji.
    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.
    Asinkrona obrada
    API odmah prihvaća zadatak i obrađuje ga u pozadini — rezultate preuzimate ispitivanjem statusa.
    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

    Saznajte više

    Provjera sankcija

    Provjerite subjekte prema svakom većem izvoru s neizravnim podudaranjem i dokazima regulatorne razine.

    Provjera klijenata i dubinska analiza

    Mapirajte vlasništvo, PEP izloženost, negativne medije i sankcijske signale za potpune profile rizika poslovnih partnera.

    Skupna provjera

    Prenesite CSV ili XLSX datoteke i verificirajte stotine klijenata, dobavljača ili partnera u jednom zadatku.

    Pokrivenost sankcijskih lista

    Pogledajte svaku sankcijsku listu, PEP bazu i jurisdikciju koju ScreenVeritAI pokriva.

    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.

    Pogledaj cijene