ScreenVeritAI · API Specv1 · GA · reference
    Fejlesztői API

    Miért másolgassa a neveket rendszerek között, ha egyetlen API-hívás mindent elvégez?

    Ágyazza be a cégellenőrzést, a tulajdonosi feltérképezést, a PEP-ellenőrzést, a negatív médiát és a szankciós jelzéseket közvetlenül meglévő munkafolyamataiba.

    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

    Saját fejlesztés vs. ScreenVeritAI integrálása

    p. 05 / 09
    Idő az éles indulásig
    Saját fejlesztés
    6-12 hónap a listák beszerzéséhez, az egyeztetés felépítéséhez, a szélsőséges esetek kezeléséhez
    ScreenVeritAI API
    Napok az integrációhoz — az első API-hívástól éles állapotban
    Szankciós lista lefedettség
    Saját fejlesztés
    Kézi feldolgozás minden listaformátumhoz; folyamatos sémakarbantartás
    ScreenVeritAI API
    Minden jelentős forrás, folyamatosan karbantartva és frissítve
    Egyeztetési pontosság
    Saját fejlesztés
    Az egyedi közelítő egyeztetés NLP-szakértelmet és állandó finomhangolást igényel
    ScreenVeritAI API
    AI közelítő egyeztetéssel, átírással, névváltozat-feloldással és fonetikus algoritmusokkal
    PEP és negatív média
    Saját fejlesztés
    Külön szolgáltatók, külön integrációk, külön költségvetések
    ScreenVeritAI API
    PEP-, negatívmédia- és UBO-adat ugyanabban az API-válaszban
    Folyamatos karbantartás
    Saját fejlesztés
    Dedikált csapat a lista- és sémafrissítésekhez, a téves találatok finomhangolásához
    ScreenVeritAI API
    Teljes körűen menedzselt — a frissítéseket, fejlesztéseket és infrastruktúrát mi kezeljük
    Auditnyom
    Saját fejlesztés
    Építse fel saját naplózási, bizonyítéki és megőrzési infrastruktúráját
    ScreenVeritAI API
    Időbélyeges bizonyítékcsomagok forráshivatkozásokkal, beépítve

    Négy lépés a beépített megfelelőségig

    p. 06 / 09
    1

    Szerezze meg API-kulcsát

    Hozzon létre egy hatáskörhöz kötött kulcsot a vezérlőpultján, legkisebb jogosultsági szintű engedélyekkel: search:read, search:write, batch:read, batch:write.

    2

    Illessze be a végpontot

    Egyetlen POST hívás az ügyfél-befogadási, fizetési vagy CRM-munkafolyamatába — küldje a szervezet nevét, típusát és országát, kapjon vissza egy job id-t.

    3

    Dolgozza fel az eredményeket

    Kérdezze le az eredmény-végpontot strukturált JSON-ért — cégkontextus, tulajdonlás, PEP, negatív média, szankciós jelzések és kockázati pontszámok.

    4

    Monitorozzon és riasszon

    Állítson be folyamatos monitorozást — az API riaszt, amikor a szankciós listák frissülnek, vagy új negatív média jelenik meg.

    Kezdje el percek alatt

    p. 07 / 09

    Egyetlen API-hívás teljes szűrési eredményt ad vissza.

    Szervezet szűrése
    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 }
    Eredmény ellenőrzése
    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 }

    API-teljesítmény

    p. 08 / 09

    €0.39

    Quick Check hívásonként, platformdíj nélkül

    202

    HTTP-státusz a keresés elfogadásakor; az eredményt ezután kell lekérdezni

    EU

    Finnországban hosztolva; a nyugalmi adatok az EU-ban maradnak

    API-integrációs GYIK

    p. 09 / 09
    01Hogyan hitelesítem az API-kéréseket?
    Hitelesítse az API-kéréseket az X-API-Key fejlécben átadott titkos kulccsal. A kulcsokat a vezérlőpultján hozza létre, korlátozott, minimálisan szükséges jogosultságokkal.
    02Az API szinkron vagy aszinkron?
    Aszinkron. Küldjön be egy kérést, kapjon egy job id-t, kérje le az eredményeket lekérdezéssel. Folyamata sosem blokkolódik.
    03Milyen válaszformátumot ad vissza az API?
    Strukturált JSON-t szankciós találatokkal, PEP-jelzésekkel, negatív médiával, megbízhatósági pontszámokkal, forráshivatkozásokkal és kockázati szint besorolással.
    04Milyen sebességkorlátok érvényesek?
    Előfizetési szint szerint, API-kulcsonként hozzárendelve. A válaszfejlécek tartalmazzák a fennmaradó kvótát és a visszaállítási időbélyeget.
    05Szűrhetek szervezeteket tömegesen az API-n keresztül?
    Igen. A tömeges végpont CSV-t vagy XLSX-et fogad, kérésenként legfeljebb 100 sorral; az eredmények soronként vagy teljes exportként kérdezhetők le.
    06Hogyan állítsak be folyamatos monitorozást az API-n keresztül?
    Állítsa be a monitorozást az első szűrés után. Amikor a listák frissülnek, vagy új negatív média jelenik meg, a monitorozás megjelöli a változást, és az alkalmazásban riasztja Önt.
    07Milyen megfelelőségi adat szerepel minden szűrési eredményben?
    Szankciós találatok minden jelentős forrásból, PEP-státusz családi kapcsolatokkal, negatív média többnyelvű hivatkozásokkal, UBO-adat, kockázati szint és időbélyeges bizonyítékcsomag.
    08Mennyi ideig tart egy szűrés?
    Standard szankciós ellenőrzés: másodpercek. Deep research negatív médiával és tulajdonosi feltérképezéssel: kevesebb mint két perc.
    API-terminológia
    REST API
    Szabványos HTTP-módszereket használó webes API — kompatibilis bármely nyelvvel vagy keretrendszerrel, amely HTTP-kéréseket tud küldeni.
    Aszinkron feldolgozás
    Az API azonnal befogadja a feladatot, és a háttérben dolgozza fel — az eredményeket lekérdezéssel kérheti le.
    API-kulcs
    Titkos token az API-kérések hitelesítéséhez, a legkisebb jogosultsághoz igazított, meghatározott engedélyekkel.
    Sebességkorlátozás
    Előfizetési szint szerint korlátozza az API-kéréseket időablakonként — a fennmaradó kvóta és a visszaállítási időbélyeg a válaszfejlécekben szerepel.
    Strukturált válasz
    Géppel olvasható JSON konzisztens mezőnevekkel és típusokkal, amely lehetővé teszi az automatizált feldolgozást és döntési logikát.
    Iparági források
    1. 01
    2. 02
      Regulatory Technology for AML/CFT Compliance

      Bank for International Settlements — FSI Insights

    3. 03
      OFAC Compliance Commitments Framework

      U.S. Department of the Treasury

    4. 04
      EU Anti-Money Laundering Authority (AMLA) Regulation

      Official Journal of the European Union

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

    End of API specification.

    Indítsa el a szűrést percek alatt.

    Válasszon csomagot, és kezdje el a szűrést még ma.