ScreenVeritAI
    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

    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

    Vlastní 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í

    Čtyři kroky k zabudované compliance

    p. 06 / 09
    1

    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.

    2

    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.

    3

    Zpracujte výsledky

    Dotazujte se pollingem na endpoint s výsledky a získejte strukturovaný JSON — kontext firmy, vlastnictví, PEP, negativní média, sankční signály a riziková skóre.

    4

    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.

    Zač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://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 }
    Zkontrolovat výsledek
    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 }

    Výkon API

    p. 08 / 09

    €0.39

    Quick Check za jedno volání, bez poplatku za platformu

    202

    HTTP stav po přijetí vyhledávání; výsledek se poté dotazuje

    EU

    Hostováno ve Finsku; data v klidu zůstávají v EU

    FAQ 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 X-API-Key. 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, získáte ID úlohy a výsledky si vyzvednete pollingem. Vaše pipeline 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, monitoring změnu označí a upozorní vás v aplikaci.
    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.
    Asynchronní zpracování
    API úlohu okamžitě přijme a zpracuje ji na pozadí — výsledky získáte pollingem.
    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
    1. 01
    2. 02
      Regulační technologie pro AML/CFT compliance

      Bank for International Settlements — FSI Insights

    3. 03
      Rámec compliance závazků OFAC

      U.S. Department of the Treasury

    4. 04
    Zjistěte více

    Screening sankcí

    Prověřte subjekty napříč každým hlavním zdrojem s fuzzy porovnáváním a důkazy pro regulátora.

    Screening klientů a due diligence

    Zmapujte vlastnictví, expozici vůči PEP, negativní média a sankční signály pro úplné rizikové profily protistran.

    Hromadný screening

    Nahrajte CSV nebo XLSX a ověřte stovky klientů či dodavatelů v jedné úloze.

    Pokrytí sankčních seznamů

    Podívejte se na všechny sankční seznamy, databáze PEP a jurisdikce, které ScreenVeritAI pokrývá.

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

    End of API specification.

    Zahajte screening během několika minut.

    Vyberte si tarif a začněte prověřovat ještě dnes.

    Zobrazit ceník