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.

    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

    Construire 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

    Patru 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 pentru 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ă.

    Î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://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 }
    Verificați rezultatul
    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 }

    Performanța API-ului

    p. 08 / 09

    €0.39

    Quick Check per apel, fără taxă de platformă

    202

    Stare HTTP când o căutare este acceptată; rezultatul se interoghează apoi

    EU

    Găzduit în Finlanda; datele în repaus rămân în UE

    Î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 X-API-Key. 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ă. 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ă, monitorizarea semnalează schimbarea și vă alertează în aplicație.
    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.
    Procesare asincronă
    API-ul acceptă imediat un job și îl procesează în fundal — preluați rezultatele prin interogare periodică.
    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.