# API dla deweloperów

Wbuduj screening compliance w dowolny workflow

Twój pipeline onboardingowy, bramka płatnicza i CRM już codziennie podejmują decyzje dotyczące ryzyka. API ScreenVeritAI pozwala wbudować screening sankcyjny, weryfikację PEP, analizę negatywnych doniesień medialnych i mapowanie UBO bezpośrednio w te procesy — bez ręcznych wyszukiwań, bez kopiowania, bez luk compliance między systemami. Jedno wywołanie API uruchamia tego samego agenta AI, który napędza naszą platformę, a ustrukturyzowany JSON wraca gotowy dla Twojego silnika decyzyjnego.

Uzyskaj klucz API Zobacz cennik

// The request

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 "deep_research"

POST /v1/screenbash

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": "deep_research"

8 }'

POST /api/v1/screen — response200 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

// The response

Structured JSON. Every risk vector. Color-coded.

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

// Endpoints

API Reference

Three endpoints cover all screening workflows.

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": "deep_research"}'

Response

200 OK

{ "request_id": "srv_a8f3c1d9", "status": "queued",

"estimated_seconds": 30, "poll_url": "/v1/result/srv_a8f3c1d9" }

// Integration patterns

Drop into your existing workflow

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

// Build vs buy

Budować czy kupić

Aspekt	Budowa wewnętrzna	API ScreenVeritAI
Czas do produkcji	6–12 miesięcy na pozyskanie list, budowę logiki dopasowywania i obsługę przypadków brzegowych	Dni na integrację; gotowe do produkcji od pierwszego wywołania API
Pokrycie list sankcyjnych	Ręczne pozyskiwanie każdego formatu listy; ciągła konserwacja przy zmianach schematów	Ponad 10 reżimów utrzymywanych i aktualizowanych na bieżąco — OFAC, EU, ONZ, UK i więcej
Dokładność dopasowania	Własne dopasowanie rozmyte wymaga ekspertyzy NLP i ciągłego dostrajania	Agent AI z dopasowaniem rozmytym, transliteracją, rozwiązywaniem aliasów i algorytmami fonetycznymi
PEP i negatywne doniesienia medialne	Osobni dostawcy danych, osobne integracje, osobne budżety	PEP, negatywne doniesienia medialne i dane UBO zawarte w tej samej odpowiedzi API
Bieżąca konserwacja	Dedykowany zespół inżynieryjny do aktualizacji list, zmian schematów i strojenia fałszywych pozytywów	W pełni zarządzane — aktualizacje list, ulepszenia modeli i infrastruktura obsługiwane za Ciebie
Ścieżka audytu	Budowa własnego logowania, generowania dowodów i infrastruktury przechowywania	Pakiety dowodowe z datą i godziną z referencjami źródłowymi i uzasadnieniem decyzji w zestawie

// How it works

Cztery kroki do produkcji

Uzyskaj klucz API

Utwórz klucz API z ograniczonymi uprawnieniami z poziomu panelu ScreenVeritAI. Przypisz uprawnienia — search:read, search:write, batch:read, batch:write — dla dostępu z minimalnym zakresem uprawnień.

Zintegruj endpoint

Dodaj pojedyncze wywołanie POST do procesu onboardingu, płatności lub CRM. Wyślij nazwę podmiotu, typ i kraj. API zwraca ID zadania do asynchronicznego pobierania wyników.

Przetwórz wyniki

Odpytuj endpoint wyników lub odbierz callback webhook. Parsuj ustrukturyzowaną odpowiedź JSON — trafienia sankcyjne, flagi PEP, trafienia negatywnych doniesień medialnych i oceny ryzyka — i przekieruj do logiki decyzyjnej.

Monitoruj i alertuj

Skonfiguruj bieżący monitoring dla zweryfikowanych podmiotów. Gdy listy sankcyjne zostaną zaktualizowane lub pojawią się nowe negatywne doniesienia medialne, API wysyła alerty, aby Twój system mógł automatycznie uruchomić ponowną weryfikację.

// Quickstart examples

Zacznij w kilka minut

Jedno wywołanie API zwraca pełny wynik screeningu.

Zweryfikuj podmiotbash

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"}'

Sprawdź wynikbash

bash

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

Wydajność API

10+

Globalnych reżimów sankcyjnych weryfikowanych na wywołanie API

<2 min

Średni czas odpowiedzi dla pełnego screeningu z pogłębioną analizą

99.9%

SLA dostępności API dla integracji produkcyjnych

// FAQ

FAQ — integracja API

#Jak uwierzytelniać żądania API?

Wszystkie żądania API są uwierzytelniane kluczem API przekazywanym w nagłówku Authorization. Klucze tworzy się z poziomu panelu ScreenVeritAI z ograniczonymi uprawnieniami (search:read, search:write, batch:read, batch:write) wymuszającymi dostęp z minimalnym zakresem uprawnień.

#Czy API jest synchroniczne czy asynchroniczne?

API wykorzystuje asynchroniczny model przetwarzania. Przesyłasz żądanie screeningu przez POST i natychmiast otrzymujesz ID zadania. Wyniki pobierasz odpytując endpoint wyników lub konfigurując callback webhook. Zapobiega to blokowaniu w Twoim pipeline'ie produkcyjnym, podczas gdy agent AI wykonuje analizę.

#W jakim formacie API zwraca odpowiedzi?

Wszystkie odpowiedzi są ustrukturyzowanym JSON ze spójnymi nazwami pól i typami. Wyniki screeningu zawierają szczegóły trafień sankcyjnych, flagi PEP, trafienia negatywnych doniesień medialnych, wskaźniki pewności, referencje źródłowe i klasyfikację poziomu ryzyka — gotowe do automatycznego parsowania i logiki decyzyjnej bez ręcznej ekstrakcji.

#Jakie limity żądań obowiązują?

Limity żądań są przypisywane według poziomu subskrypcji i egzekwowane per klucz API. Nagłówki odpowiedzi zawierają aktualny limit, pozostałą liczbę żądań i czas resetu. Jeśli potrzebujesz wyższej przepustowości do przetwarzania masowego, endpoint wsadowy akceptuje przesyłanie plików CSV/XLSX do screeningu dużych wolumenów.

#Czy mogę weryfikować podmioty wsadowo przez API?

Tak. Endpoint wsadowy akceptuje pliki CSV lub XLSX z maksymalnie 100 wierszami na żądanie. Każdy wiersz jest przetwarzany jako indywidualny screening, a wyniki można pobierać per wiersz lub jako kompletny eksport po zakończeniu zadania.

#Jak skonfigurować bieżący monitoring przez API?

Po wstępnym screeningu możesz skonfigurować monitoring dla zweryfikowanego podmiotu. Gdy listy sankcyjne zostaną zaktualizowane lub pojawią się nowe negatywne doniesienia medialne, API wysyła powiadomienie webhook na skonfigurowany endpoint, aby Twój system mógł automatycznie uruchomić ponowną weryfikację lub eskalację.

#Jakie dane compliance zawiera każdy wynik screeningu?

Każdy wynik zawiera trafienia sankcyjne w ponad 10 reżimach, status PEP z powiązaniami rodzinnymi i współpracownikami, trafienia negatywnych doniesień medialnych z wielojęzycznymi cytowaniami źródeł, dane własności UBO, klasyfikację poziomu ryzyka i pakiet dowodowy z datą i godziną odpowiedni do audytu i przeglądu regulacyjnego.

#Jak długo trwa screening?

Standardowa weryfikacja sankcyjna zazwyczaj kończy się w sekundach. Pogłębiony screening — obejmujący analizę negatywnych doniesień medialnych i mapowanie własności — trwa średnio poniżej dwóch minut. Model asynchroniczny oznacza, że Twój system nigdy nie jest blokowany w oczekiwaniu na wyniki.

Terminologia API

REST API

Architektura API webowego wykorzystująca standardowe metody HTTP (GET, POST, PUT, DELETE) do interakcji z zasobami. API ScreenVeritAI stosuje konwencje REST, dzięki czemu jest kompatybilne z dowolnym językiem programowania lub frameworkiem zdolnym do wykonywania żądań HTTP.

Webhook

Callback HTTP między serwerami uruchamiany przez zdarzenie. Zamiast odpytywać o wyniki, możesz skonfigurować ScreenVeritAI do wysyłania żądania POST na Twój endpoint po zakończeniu screeningu lub wykryciu zmiany przez bieżący monitoring.

Przetwarzanie asynchroniczne

Model żądań, w którym API natychmiast przyjmuje zadanie i przetwarza je w tle. Klient otrzymuje ID zadania i pobiera wyniki później przez odpytywanie lub webhook. Ten wzorzec zapobiega blokowaniu w pipeline'ach produkcyjnych.

Klucz API

Tajny token używany do uwierzytelniania żądań API między serwerami. Klucze API ScreenVeritAI mają określone uprawnienia (search:read, search:write, batch:read, batch:write) wymuszające wzorce dostępu z minimalnym zakresem uprawnień.

Ograniczenie liczby żądań (rate limiting)

Mechanizm ograniczający liczbę żądań API, które klient może wykonać w określonym oknie czasowym. Limity są przypisywane według poziomu subskrypcji i komunikowane przez nagłówki odpowiedzi zawierające pozostały limit i czas resetu.

Ustrukturyzowana odpowiedź

Format odpowiedzi API czytelny maszynowo (JSON) ze spójnymi nazwami pól, typami i zagnieżdżeniem. Ustrukturyzowane odpowiedzi umożliwiają automatyczne parsowanie, logikę decyzyjną i generowanie ścieżki audytu bez ręcznej ekstrakcji danych.

/* Źródła branżowe */

[1]
Wytyczne FATF dotyczące tożsamości cyfrowej i należytej staranności wobec klienta
Grupa Specjalna ds. Przeciwdziałania Praniu Pieniędzy (FATF)
[2]
Technologia regulacyjna dla compliance AML/CFT
Bank Rozrachunków Międzynarodowych — FSI Insights
[3]
Ramy zobowiązań OFAC dotyczące compliance
Departament Skarbu USA
[4]
Rozporządzenie o Urzędzie UE ds. Przeciwdziałania Praniu Pieniędzy (AMLA)
Dziennik Urzędowy Unii Europejskiej

Wbuduj screening compliance w dowolny workflow

One POST call. That's your entire integration.

Structured JSON. Every risk vector. Color-coded.

API Reference

Drop into your existing workflow

Budować czy kupić

Cztery kroki do produkcji

Zacznij w kilka minut

Wydajność API

FAQ — integracja API

Terminologia API

/* Źródła branżowe */

// Odkryj więcej

Screening sankcyjny

Screening klientów i due diligence

Screening wsadowy

Pokrycie list sankcyjnych

Zacznij sprawdzanie w kilka minut.