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.

Pridobite API ključ Oglejte si cenik

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

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

Gradnja 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

Vidik

Gradnja lastne rešitve

API ScreenVeritAI

Čas do produkcije

6–12 mesecev za pridobitev seznamov, gradnjo ujemanja in obravnavo posebnih primerov

Dnevi do integracije — pripravljeno za produkcijo že od prvega klica API

Pokritost seznamov sankcij

Ročno vnašanje vsake oblike seznama; stalno vzdrževanje sheme

Vsak večji vir, stalno vzdrževan in posodabljan

Natančnost ujemanja

Lastno približno ujemanje zahteva strokovnost NLP in stalno prilagajanje

UI s približnim ujemanjem, transliteracijo, razreševanjem vzdevkov in fonetičnimi algoritmi

PEP in negativni mediji

Ločeni ponudniki, ločene integracije, ločeni proračuni

Podatki PEP, negativnih medijev in UBO v istem odgovoru API

Stalno vzdrževanje

Namenska ekipa za posodobitve seznamov, spremembe sheme, prilagajanje lažno pozitivnih zadetkov

Popolnoma upravljano — posodobitve, izboljšave in infrastruktura poskrbljene za vas

Revizijska sled

Zgradite lastno infrastrukturo za beleženje, dokaze in hranjenje

Dokazni paketi s časovnim žigom, ki vključujejo navedbo virov

Štirje koraki do vgrajene skladnosti

p. 06 / 09

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.

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.

Obdelajte rezultate

Anketirajte endpoint za rezultate za strukturiran JSON — kontekst podjetja, lastništvo, PEP, negativni mediji, sankcijski signali in ocene tveganja.

Spremljajte in opozarjajte

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

Začnite v nekaj minutah

p. 07 / 09

En sam klic API vrne popoln rezultat preverjanja.

Preverite 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 }

Preverite 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 }

Zmogljivost API

p. 08 / 09

€0.39

Quick Check na klic, brez platformne pristojbine

202

HTTP status ob sprejetem iskanju; rezultat nato poizvedujete

Gostovanje na Finskem; podatki v mirovanju ostanejo v EU

Pogosta vprašanja o integraciji API

p. 09 / 09

01Kako avtenticiram zahtevke API?

Zahtevke API avtenticirajte s skrivnim ključem, posredovanim v glavi X-API-Key. 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. 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, spremljanje označi spremembo in vas opozori v aplikaciji.

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.

Asinhrona obdelava

API opravilo takoj sprejme in ga obdela v ozadju — rezultate pridobite z anketiranjem.

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

01
FATF Guidance on Digital Identity and Customer Due Diligence
Financial Action Task Force
02
Regulatory Technology for AML/CFT Compliance
Bank for International Settlements — FSI Insights
03
OFAC Compliance Commitments Framework
U.S. Department of the Treasury
04
EU Anti-Money Laundering Authority (AMLA) Regulation
Official Journal of the European Union

Raziščite več

End of API specification.

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

The request

One POST call, then your poll loop.

The response

Structured JSON. Findings, not a score.

API reference

Integration patterns

Gradnja lastne rešitve proti integraciji ScreenVeritAI

Štirje koraki do vgrajene skladnosti

Začnite v nekaj minutah

Zmogljivost API

Pogosta vprašanja o integraciji API

Preverjanje sankcij

Preverjanje strank in skrbni pregled

Paketno preverjanje

Pokritost sankcijskih seznamov

Začnite preverjanje v nekaj minutah.