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

    §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

    §05Costruire 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

    §06Quattro 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 o riceva un callback webhook con 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.

    §07Iniziare 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://api.screenveritai.com/v1/screen \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Acme Trading LLC", "country": "AE"}'
    Verifica il risultato
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

    §08Prestazioni dell'API

    p. 08 / 09

    Tutte

    Le principali fonti verificate per chiamata API

    <2 min

    Tempo di risposta medio per uno screening completo con deep research

    99,9%

    SLA di uptime dell'API per le integrazioni in produzione

    §09FAQ sull'integrazione API

    p. 09 / 09
    01Come autentico le richieste API?
    Autentichi le richieste API con una chiave segreta trasmessa nell'intestazione Authorization. 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 o webhook. 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, l'API invia un webhook al Suo endpoint.
    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.
    Webhook
    Callback HTTP server-to-server attivato quando uno screening si completa o il monitoraggio rileva una modifica.
    Elaborazione asincrona
    L'API accetta un job immediatamente e lo elabora in background — recupera i risultati tramite polling o webhook.
    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