ScreenVeritAI
    ScreenVeritAI · API Specv1 · GA · reference
    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 APIZobacz cennik

    §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

    §05Budować czy kupić

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

    §06Cztery kroki do produkcji

    p. 06 / 09
    1

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

    2

    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.

    3

    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.

    4

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

    §07Zacznij w kilka minut

    p. 07 / 09

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

    Zweryfikuj podmiot
    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ź wynik
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

    §08Wydajność API

    p. 08 / 09

    Wszystkie

    Główne źródła weryfikowane 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

    §09FAQ — integracja API

    p. 09 / 09
    01Jak 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ń.
    02Czy 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ę.
    03W 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.
    04Jakie 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.
    05Czy 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.
    06Jak 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ę.
    07Jakie dane compliance zawiera każdy wynik screeningu?
    Każdy wynik zawiera trafienia sankcyjne w każdym głównym źródle, 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.
    08Jak 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. 01
      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. 02
      Technologia regulacyjna dla compliance AML/CFT

      Bank Rozrachunków Międzynarodowych — FSI Insights

    3. 03
    4. 04
    Odkryj więcej

    Screening sankcyjny

    Weryfikuj podmioty w każdym głównym źródle z dopasowaniem rozmytym i dowodami klasy egzekucyjnej.

    Screening klientów i due diligence

    Wykraczaj poza listy sankcyjne — mapuj własność, ekspozycję PEP i negatywne doniesienia medialne dla pełnych profili ryzyka.

    Screening wsadowy

    Prześlij pliki CSV lub XLSX i zweryfikuj setki podmiotów we wszystkich reżimach sankcyjnych w jednym zadaniu.

    Pokrycie list sankcyjnych

    Zobacz każdą listę sankcyjną, bazę PEP i jurysdykcję, którą obejmuje ScreenVeritAI.

    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    Zacznij screening w kilka minut.

    Wybierz plan i zacznij sprawdzać już dziś.

    Zobacz cennik