ScreenVeritAI · API Specv1 · GA · reference

Developer API

Proč kopírovat jména mezi systémy, když to zvládne jedno volání API?

Zabudujte ověřování firem, mapování vlastnictví, kontrolu PEP, negativní média a sankční signály přímo do svých stávajících procesů.

Získat API klíč Zobrazit ceník

§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

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

§05Vlastní vývoj vs. integrace ScreenVeritAI

p. 05 / 09

Doba do nasazení

Vlastní vývoj: 6–12 měsíců na získání seznamů, vybudování porovnávání a řešení výjimek
API ScreenVeritAI: Integrace za dny — připraveno k produkčnímu nasazení od prvního volání API

Pokrytí sankčních seznamů

Vlastní vývoj: Ruční zpracování formátu každého seznamu; průběžná údržba schémat
API ScreenVeritAI: Každý hlavní zdroj, průběžně udržovaný a aktualizovaný

Přesnost porovnávání

Vlastní vývoj: Vlastní fuzzy porovnávání vyžaduje odbornost v NLP a neustálé ladění
API ScreenVeritAI: AI s fuzzy porovnáváním, přepisem do latinky, rozpoznáváním aliasů a fonetickými algoritmy

PEP a negativní média

Vlastní vývoj: Samostatní dodavatelé, samostatné integrace, samostatné rozpočty
API ScreenVeritAI: Data PEP, negativních médií a UBO v jedné odpovědi API

Průběžná údržba

Vlastní vývoj: Vyhrazený tým pro aktualizace seznamů, změny schémat a ladění falešných shod
API ScreenVeritAI: Plně spravováno — aktualizace, vylepšení i infrastrukturu řešíme za vás

Auditní stopa

Vlastní vývoj: Vybudujte si vlastní infrastrukturu pro logování, důkazy a uchovávání záznamů
API ScreenVeritAI: Časově orazítkované balíčky důkazů se zdrojovými odkazy jsou součástí

Aspekt

Vlastní vývoj

API ScreenVeritAI

Doba do nasazení

6–12 měsíců na získání seznamů, vybudování porovnávání a řešení výjimek

Integrace za dny — připraveno k produkčnímu nasazení od prvního volání API

Pokrytí sankčních seznamů

Ruční zpracování formátu každého seznamu; průběžná údržba schémat

Každý hlavní zdroj, průběžně udržovaný a aktualizovaný

Přesnost porovnávání

Vlastní fuzzy porovnávání vyžaduje odbornost v NLP a neustálé ladění

AI s fuzzy porovnáváním, přepisem do latinky, rozpoznáváním aliasů a fonetickými algoritmy

PEP a negativní média

Samostatní dodavatelé, samostatné integrace, samostatné rozpočty

Data PEP, negativních médií a UBO v jedné odpovědi API

Průběžná údržba

Vyhrazený tým pro aktualizace seznamů, změny schémat a ladění falešných shod

Plně spravováno — aktualizace, vylepšení i infrastrukturu řešíme za vás

Auditní stopa

Vybudujte si vlastní infrastrukturu pro logování, důkazy a uchovávání záznamů

Časově orazítkované balíčky důkazů se zdrojovými odkazy jsou součástí

§06Čtyři kroky k zabudované compliance

p. 06 / 09

Získejte API klíč

Vytvořte si v dashboardu klíč s omezeným rozsahem a nejnižšími nutnými oprávněními: search:read, search:write, batch:read, batch:write.

Integrujte endpoint

Jedno POST volání do vašeho onboardingového, platebního nebo CRM procesu — pošlete jméno subjektu, typ a zemi, dostanete zpět id úlohy.

Zpracujte výsledky

Dotazujte se na endpoint výsledků, nebo přijměte zpětné volání webhooku se strukturovaným JSON — kontext firmy, vlastnictví, PEP, negativní média, sankční signály a riziková skóre.

Monitorujte a upozorňujte

Nastavte průběžný monitoring — API pošle upozornění, když se aktualizují sankční seznamy nebo se objeví nová negativní média.

§07Začněte během minut

p. 07 / 09

Jedno volání API vrátí kompletní výsledek screeningu.

Prověřit 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"}'

Zkontrolovat výsledek

bash

curl https://api.screenveritai.com/v1/results/RESULT_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

§08Výkon API

p. 08 / 09

Vše

Hlavních zdrojů prověřených při každém volání API

<2 min

Průměrná doba odezvy u kompletního screeningu s hloubkovým výzkumem

99,9 %

SLA dostupnosti API pro produkční integrace

§09FAQ k integraci API

p. 09 / 09

01Jak se autentizují API požadavky?

API požadavky autentizujte tajným klíčem předávaným v hlavičce Authorization. Klíče se vytváří ve vašem dashboardu s omezeným rozsahem oprávnění.

02Je API synchronní, nebo asynchronní?

Asynchronní. Odešlete požadavek, dostanete id úlohy, výsledky si vyzvednete dotazováním nebo webhookem. Váš proces se nikdy nezablokuje.

03V jakém formátu API vrací odpověď?

Strukturovaný JSON se sankčními shodami, příznaky PEP, negativními médii, skóre spolehlivosti, zdrojovými odkazy a klasifikací rizikové úrovně.

04Jaké limity požadavků platí?

Přidělují se podle tarifu předplatného pro každý API klíč zvlášť. Hlavičky odpovědi obsahují zbývající kvótu a čas obnovení.

05Můžu subjekty prověřovat hromadně přes API?

Ano. Endpoint pro dávky přijímá CSV nebo XLSX s až 100 řádky na požadavek, výsledky si vyzvednete po řádcích nebo jako kompletní export.

06Jak nastavím průběžný monitoring přes API?

Monitoring nastavíte po úvodním screeningu. Když se seznamy aktualizují nebo se objeví nová negativní média, API pošle webhook na váš endpoint.

07Jaká compliance data jsou součástí každého výsledku screeningu?

Sankční shody napříč každým hlavním zdrojem, status PEP včetně rodinných vazeb, negativní média s vícejazyčnými citacemi, data UBO, riziková úroveň a časově orazítkovaný balíček důkazů.

08Jak dlouho screening trvá?

Standardní kontrola sankcí: sekundy. Hloubkový výzkum s negativními médii a mapováním vlastnictví: pod dvě minuty.

Terminologie API

REST API

Webové API využívající standardní HTTP metody — kompatibilní s jakýmkoli jazykem nebo frameworkem, který umí odesílat HTTP požadavky.

Webhook

HTTP zpětné volání mezi servery, spuštěné po dokončení screeningu nebo když monitoring zjistí změnu.

Asynchronní zpracování

API přijme úlohu okamžitě a zpracuje ji na pozadí — výsledky si vyzvednete dotazováním nebo webhookem.

API klíč

Tajný token pro autentizaci API požadavků, s omezeným rozsahem oprávnění pro přístup s nejnižšími nutnými právy.

Omezení počtu požadavků (rate limiting)

Omezuje počet API požadavků za časové okno podle tarifu předplatného — zbývající kvóta a čas obnovení jsou v hlavičkách odpovědi.

Strukturovaná odpověď

Strojově čitelný JSON s konzistentními názvy a typy polí, umožňující automatizované zpracování a rozhodovací logiku.

Oborové zdroje

01
Pokyny FATF k digitální identitě a hloubkové kontrole klienta
Financial Action Task Force
02
Regulační technologie pro AML/CFT compliance
Bank for International Settlements — FSI Insights
03
Rámec compliance závazků OFAC
U.S. Department of the Treasury
04
Nařízení o Úřadu EU pro boj proti praní špinavých peněz (AMLA)
Úřední věstník Evropské unie

Zjistěte více

End of API specification.

Proč kopírovat jména mezi systémy, když to zvládne jedno volání API?

§01The request

One POST call. That's your entire integration.

§02The response

Structured JSON. Every risk vector.

§03API reference

§04Integration patterns

§05Vlastní vývoj vs. integrace ScreenVeritAI

§06Čtyři kroky k zabudované compliance

§07Začněte během minut

§08Výkon API

§09FAQ k integraci API

Screening sankcí

Screening klientů a due diligence

Hromadný screening

Pokrytí sankčních seznamů

Zahajte screening během několika minut.