ScreenVeritAI
    ScreenVeritAI · API Specv1 · GA · reference
    API per sviluppatori

    Perché copiare i nomi manualmente tra sistemi quando una chiamata API fa tutto?

    Integri verifica aziendale, mappatura titolarità, controlli PEP, adverse media e segnali di sanzioni direttamente nei Suoi workflow esistenti.

    Ottieni API keyVedi prezzi

    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

    Costruire in casa vs. integrare ScreenVeritAI

    p. 05 / 09
    Tempo alla produzione
    Costruire in casa
    6-12 mesi per reperire le liste, costruire il matching, gestire i casi limite
    API ScreenVeritAI
    Giorni per integrare — pronta per la produzione dalla prima chiamata API
    Copertura liste di sanzioni
    Costruire in casa
    Acquisizione manuale di ogni formato di lista; manutenzione continua dello schema
    API ScreenVeritAI
    Ogni fonte principale, mantenuta e aggiornata in modo continuo
    Precisione del matching
    Costruire in casa
    Il fuzzy matching personalizzato richiede competenze NLP e messa a punto costante
    API ScreenVeritAI
    IA con fuzzy matching, traslitterazione, risoluzione degli alias, algoritmi fonetici
    PEP e adverse media
    Costruire in casa
    Fornitori separati, integrazioni separate, budget separati
    API ScreenVeritAI
    Dati PEP, adverse media e UBO nella stessa risposta API
    Manutenzione continua
    Costruire in casa
    Un team dedicato per aggiornamenti delle liste, modifiche allo schema, messa a punto dei falsi positivi
    API ScreenVeritAI
    Completamente gestita — aggiornamenti, miglioramenti e infrastruttura a Suo carico zero
    Audit trail
    Costruire in casa
    Costruisca da solo il Suo sistema di log, evidenze e conservazione
    API ScreenVeritAI
    Fascicoli di evidenza con data e ora e riferimenti alle fonti inclusi

    Quattro passaggi verso la conformità integrata

    p. 06 / 09
    1

    Ottieni la Sua API key

    Crei una chiave con permessi definiti dalla Sua dashboard, a privilegio minimo: search:read, search:write, batch:read, batch:write.

    2

    Integra l'endpoint

    Una chiamata POST nel Suo workflow di onboarding, pagamento o CRM — invii nome, tipo e paese dell'entità, ottenga un job ID in risposta.

    3

    Elabora i risultati

    Effettui il polling dell'endpoint dei risultati per JSON strutturato — contesto aziendale, titolarità, PEP, adverse media, segnali di sanzioni e punteggi di rischio.

    4

    Monitora e ricevi alert

    Configuri il monitoraggio continuo — l'API invia alert quando le liste di sanzioni si aggiornano o emergono nuovi adverse media.

    Iniziare in pochi minuti

    p. 07 / 09

    Un'unica chiamata API restituisce un risultato di screening completo.

    Sottoponi un'entità a screening
    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 il risultato
    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 }

    Prestazioni dell'API

    p. 08 / 09

    €0.39

    Quick Check per chiamata, nessun canone di piattaforma

    202

    Stato HTTP quando una ricerca è accettata; il risultato si ottiene con polling

    EU

    Ospitato in Finlandia; i dati a riposo restano nell'UE

    FAQ sull'integrazione API

    p. 09 / 09
    01Come autentico le richieste API?
    Autentichi le richieste API con una chiave segreta trasmessa nell'intestazione X-API-Key. Le chiavi vengono create dalla Sua dashboard con permessi definiti e a privilegio minimo.
    02L'API è sincrona o asincrona?
    Asincrona. Invia una richiesta, ottiene un job ID, recupera i risultati tramite polling. La Sua pipeline non si blocca mai.
    03Che formato di risposta restituisce l'API?
    JSON strutturato con corrispondenze di sanzioni, segnalazioni PEP, adverse media, punteggi di confidenza, riferimenti alle fonti e classificazione per livello di rischio.
    04Quali rate limit si applicano?
    Assegnati in base al piano di abbonamento per ogni API key. Le intestazioni di risposta includono la quota residua e il timestamp di reset.
    05Posso sottoporre a screening le entità in batch tramite l'API?
    Sì. L'endpoint batch accetta CSV o XLSX con un massimo di 100 righe per richiesta, con risultati recuperabili per riga o come esportazione completa.
    06Come imposto il monitoraggio continuo tramite l'API?
    Configuri il monitoraggio dopo lo screening iniziale. Quando le liste si aggiornano o emergono nuovi adverse media, il monitoraggio segnala il cambiamento e La avvisa in-app.
    07Quali dati di conformità sono inclusi in ogni risultato di screening?
    Corrispondenze di sanzioni su ogni principale fonte, stato PEP con collegamenti familiari, adverse media con citazioni multilingue, dati UBO, livello di rischio e fascicolo di evidenza con data e ora.
    08Quanto tempo richiede uno screening?
    Controllo sanzioni standard: pochi secondi. Deep research con adverse media e mappatura della titolarità: meno di due minuti.
    Terminologia API
    API REST
    API web che usa metodi HTTP standard — compatibile con qualsiasi linguaggio o framework in grado di effettuare richieste HTTP.
    Elaborazione asincrona
    L'API accetta subito il job e lo elabora in background — recuperi i risultati tramite polling.
    API key
    Token segreto per autenticare le richieste API, con permessi definiti per un accesso a privilegio minimo.
    Rate limiting
    Limita le richieste API per finestra temporale in base al piano di abbonamento — quota residua e timestamp di reset nelle intestazioni di risposta.
    Risposta strutturata
    JSON leggibile da macchina con nomi e tipi di campo coerenti, che consente parsing automatico e logica decisionale.
    Fonti di settore
    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

    Scopri di più

    Screening sanzioni

    Verifichi le entità su ogni principale fonte con fuzzy matching ed evidenze pronte per l'enforcement.

    Screening clienti e adeguata verifica

    Mappi titolarità, esposizione PEP, adverse media e segnali di sanzioni per profili di rischio completi sulle controparti.

    Screening batch

    Carichi file CSV o XLSX e verifichi centinaia di clienti, fornitori o vendor in un unico job.

    Copertura delle liste di sanzioni

    Veda ogni lista di sanzioni, database PEP e giurisdizione coperti da ScreenVeritAI.

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

    End of API specification.

    Avvii lo screening in pochi minuti.

    Scelga un piano e inizi oggi stesso lo screening.

    Vedi prezzi