ScreenVeritAI · API Specv1 · GA · reference
    API pentru dezvoltatori

    De ce să copiați nume între sisteme, când un singur apel API face totul?

    Integrați verificarea companiilor, maparea proprietății, verificările PEP, media adversă și semnalele de sancțiuni direct în fluxurile dumneavoastră existente.

    §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

    §05Construire internă vs. integrare ScreenVeritAI

    p. 05 / 09
    Timp până la producție
    Construire internă
    6-12 luni pentru a obține listele, a construi potrivirea și a gestiona cazurile particulare
    API ScreenVeritAI
    Zile pentru integrare — gata de producție de la primul apel API
    Acoperirea listelor de sancțiuni
    Construire internă
    Preluare manuală a fiecărui format de listă; întreținere continuă a schemei
    API ScreenVeritAI
    Fiecare sursă majoră, întreținută și actualizată continuu
    Acuratețea potrivirii
    Construire internă
    Potrivirea fuzzy personalizată necesită expertiză NLP și ajustare constantă
    API ScreenVeritAI
    AI cu potrivire fuzzy, transliterare, rezolvarea aliasurilor, algoritmi fonetici
    PEP și media adversă
    Construire internă
    Furnizori separați, integrări separate, bugete separate
    API ScreenVeritAI
    Date PEP, media adversă și UBO în același răspuns API
    Mentenanță continuă
    Construire internă
    Echipă dedicată pentru actualizări de liste, modificări de schemă, ajustarea falsurilor pozitive
    API ScreenVeritAI
    Complet gestionat — actualizări, îmbunătățiri și infrastructură, asigurate pentru dumneavoastră
    Jurnal de audit
    Construire internă
    Construiți-vă propria infrastructură de jurnalizare, dovezi și retenție
    API ScreenVeritAI
    Pachete de dovezi cu marcaj temporal și referințe la surse, incluse

    §06Patru pași către conformitate integrată

    p. 06 / 09
    1

    Obțineți cheia API

    Creați o cheie cu permisiuni definite din panoul de control, cu privilegii minime: search:read, search:write, batch:read, batch:write.

    2

    Integrați endpoint-ul

    Un singur apel POST către fluxul dumneavoastră de onboarding, plăți sau CRM — trimiteți numele entității, tipul și țara, primiți înapoi un id de job.

    3

    Procesați rezultatele

    Interogați endpoint-ul de rezultate sau primiți un callback webhook cu JSON structurat — context al companiei, proprietate, PEP, media adversă, semnale de sancțiuni și scoruri de risc.

    4

    Monitorizați și alertați

    Configurați monitorizarea continuă — API-ul trimite alerte atunci când listele de sancțiuni se actualizează sau apare media adversă nouă.

    §07Începeți în câteva minute

    p. 07 / 09

    Un singur apel API returnează un rezultat complet de screening.

    Verificați o entitate
    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"}'
    Verificați rezultatul
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08Performanța API-ului

    p. 08 / 09

    Toate

    Surse majore verificate per apel API

    <2 min

    Timp mediu de răspuns pentru un screening complet, cu cercetare aprofundată

    99,9%

    SLA de disponibilitate API pentru integrările de producție

    §09Întrebări frecvente despre integrarea API

    p. 09 / 09
    01Cum autentific cererile API?
    Autentificați cererile API cu o cheie secretă transmisă în header-ul Authorization. Cheile sunt create din panoul de control, cu permisiuni definite și de privilegiu minim.
    02API-ul este sincron sau asincron?
    Asincron. Trimiteți o cerere, primiți un id de job, recuperați rezultatele prin interogare periodică sau webhook. Fluxul dumneavoastră nu se blochează niciodată.
    03Ce format de răspuns returnează API-ul?
    JSON structurat, cu potriviri de sancțiuni, semnale PEP, media adversă, scoruri de încredere, referințe la surse și clasificare pe niveluri de risc.
    04Ce limite de rată se aplică?
    Alocate în funcție de planul de abonament, per cheie API. Header-ele de răspuns includ cota rămasă și momentul resetării.
    05Pot verifica entități în masă, prin API?
    Da. Endpoint-ul de procesare în masă acceptă CSV sau XLSX cu până la 100 de rânduri per cerere, iar rezultatele pot fi recuperate per rând sau ca export complet.
    06Cum configurez monitorizarea continuă prin API?
    Configurați monitorizarea după screeningul inițial. Când listele se actualizează sau apare media adversă nouă, API-ul trimite un webhook către endpoint-ul dumneavoastră.
    07Ce date de conformitate sunt incluse în fiecare rezultat de screening?
    Potriviri de sancțiuni în fiecare sursă majoră, statut PEP cu conexiuni de familie, media adversă cu citări multilingve, date UBO, nivel de risc și pachet de dovezi cu marcaj temporal.
    08Cât durează un screening?
    Verificare standard de sancțiuni: câteva secunde. Cercetare aprofundată, cu media adversă și mapare a proprietății: sub două minute.
    Terminologie API
    API REST
    API web care utilizează metode HTTP standard — compatibil cu orice limbaj sau framework care poate face cereri HTTP.
    Webhook
    Callback HTTP server-to-server, declanșat atunci când un screening se finalizează sau monitorizarea detectează o schimbare.
    Procesare asincronă
    API-ul acceptă un job imediat și îl procesează în fundal — recuperați rezultatele prin interogare periodică sau webhook.
    Cheie API
    Token secret pentru autentificarea cererilor API, cu permisiuni definite, pentru acces cu privilegii minime.
    Limitarea ratei
    Restricționează cererile API per fereastră de timp, în funcție de planul de abonament — cota rămasă și momentul resetării sunt în header-ele de răspuns.
    Răspuns structurat
    JSON care poate fi citit automat, cu nume și tipuri de câmpuri consistente, permițând parsarea automată și logica de decizie.
    Surse din industrie
    1. 01
    2. 02
      Tehnologie de reglementare pentru conformitatea AML/CFT

      Bank for International Settlements — FSI Insights

    3. 03
      Cadrul de angajamente de conformitate OFAC

      U.S. Department of the Treasury

    4. 04
    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    Începeți screeningul în câteva minute.

    Alegeți un plan și începeți screeningul chiar azi.