ScreenVeritAI · API Specv1 · GA · reference
    Developer API

    Integreer compliancescreening in elke workflow

    Uw onboardingpijplijn, betalingsgateway en CRM nemen elke dag al risicobeslissingen. Met de API van ScreenVeritAI kunt u sanctiescreening, PEP-controles, analyse van adverse media (negatieve berichtgeving) en de identificatie van uiteindelijk belanghebbenden (UBO-mapping) rechtstreeks in die workflows integreren — geen handmatige opzoekingen, geen kopiëren-plakken, geen compliancelacunes tussen systemen. Eén API-aanroep activeert dezelfde AI-agent die ons platform aandrijft, en gestructureerde JSON komt terug, klaar voor uw beslissingsengine.

    §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

    §05Zelf bouwen vs. kopen

    p. 05 / 09
    Tijd tot productie
    Zelf bouwen
    6-12 maanden om lijsten te sourcen, matchinglogica te bouwen en randgevallen af te handelen
    ScreenVeritAI API
    Dagen om te integreren; productieklaar vanaf de eerste API-aanroep
    Sanctielijstdekking
    Zelf bouwen
    Handmatige inname van elk lijstformaat; doorlopend onderhoud bij schema-wijzigingen
    ScreenVeritAI API
    Elke grote bron, doorlopend onderhouden en bijgewerkt
    Matchingnauwkeurigheid
    Zelf bouwen
    Custom fuzzy matching vereist NLP-expertise en continue afstemming
    ScreenVeritAI API
    AI-agent met fuzzy matching, transliteratie, aliasresolutie en fonetische algoritmen
    PEP en adverse media
    Zelf bouwen
    Afzonderlijke dataleveranciers, afzonderlijke integraties, afzonderlijke budgetten
    ScreenVeritAI API
    PEP, adverse media en UBO-gegevens opgenomen in hetzelfde API-antwoord
    Doorlopend onderhoud
    Zelf bouwen
    Toegewijd engineeringteam voor lijstupdates, schema-wijzigingen en afstemming van false positives
    ScreenVeritAI API
    Volledig beheerd — lijstupdates, modelverbeteringen en infrastructuur worden voor u afgehandeld
    Auditspoor
    Zelf bouwen
    Bouw uw eigen logging, bewijs-generatie en bewaar-infrastructuur
    ScreenVeritAI API
    Bewijspakketten met tijdstempel inclusief bronreferenties en besluitrationale inbegrepen

    §06Vier stappen naar productie

    p. 06 / 09
    1

    Uw API-sleutel ophalen

    Maak een API-sleutel met beperkte rechten aan vanuit uw ScreenVeritAI-dashboard. Wijs permissies toe — search:read, search:write, batch:read, batch:write — voor least-privilege toegang.

    2

    Het endpoint integreren

    Voeg een enkele POST-aanroep toe aan uw onboarding-, betalings- of CRM-workflow. Stuur de entiteitsnaam, het type en het land. De API retourneert een taak-ID voor asynchrone resultaatopvraging.

    3

    Resultaten verwerken

    Poll het resultaten-endpoint of ontvang een webhook-callback. Parseer het gestructureerde JSON-antwoord — sanctietreffers, PEP-signaleringen, adverse media-treffers en risicoscores — en routeer naar uw beslissingslogica.

    4

    Monitoren en waarschuwen

    Configureer doorlopende monitoring voor gescreende entiteiten. Wanneer sanctielijsten worden bijgewerkt of nieuwe adverse media opduikt, stuurt de API meldingen zodat uw systeem automatisch herscreening kan triggeren.

    §07Binnen enkele minuten aan de slag

    p. 07 / 09

    Eén API-aanroep retourneert een volledig screeningresultaat.

    Een entiteit screenen
    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"}'
    Resultaat opvragen
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08API-prestaties

    p. 08 / 09

    Alle

    Belangrijke bronnen gescreend per API-aanroep

    <2 min

    Gemiddelde responstijd voor een volledige screening met diepteonderzoek

    99.9%

    API-uptime SLA voor productie-integraties

    §09Veelgestelde vragen over API-integratie

    p. 09 / 09
    01Hoe authenticeer ik API-verzoeken?
    Alle API-verzoeken worden geauthenticeerd met een API-sleutel die wordt meegegeven in de Authorization header. Sleutels worden aangemaakt vanuit uw ScreenVeritAI-dashboard met beperkte permissies (search:read, search:write, batch:read, batch:write) om least-privilege toegang af te dwingen.
    02Is de API synchroon of asynchroon?
    De API gebruikt een asynchroon verwerkingsmodel. U dient een screeningverzoek in via POST en ontvangt direct een taak-ID. Resultaten worden opgehaald door het resultaten-endpoint te pollen of door een webhook-callback te configureren. Dit voorkomt blokkering in uw productie-pipeline terwijl de AI-agent de analyse afrondt.
    03Welk responseformaat retourneert de API?
    Alle responses zijn gestructureerde JSON met consistente veldnamen en typen. Screeningresultaten bevatten sanctietrefferdetails, PEP-signaleringen, adverse media-treffers, betrouwbaarheidsscores, bronreferenties en risiconiveauclassificatie — klaar voor geautomatiseerde parsing en beslissingslogica zonder handmatige extractie.
    04Welke rate limits gelden er?
    Rate limits worden toegewezen per abonnementsniveau en afgedwongen per API-sleutel. Response headers bevatten uw huidige limiet, resterend quotum en reset-tijdstempel. Als u hogere doorvoer nodig heeft voor bulkverwerking, accepteert het batch-endpoint CSV-/XLSX-uploads voor screenings met hoog volume.
    05Kan ik entiteiten in batch screenen via de API?
    Ja. Het batch-endpoint accepteert CSV- of XLSX-bestanden met maximaal 100 rijen per verzoek. Elke rij wordt verwerkt als een individuele screening en resultaten zijn opvraagbaar per rij of als een volledige downloadbare export wanneer de taak is afgerond.
    06Hoe stel ik doorlopende monitoring in via de API?
    Na een initiële screening kunt u monitoring configureren voor de gescreende entiteit. Wanneer sanctielijsten worden bijgewerkt of nieuwe adverse media opduikt, stuurt de API een webhook-melding naar uw geconfigureerde endpoint zodat uw systeem automatisch herscreening of escalatie kan triggeren.
    07Welke compliancegegevens zijn opgenomen in elk screeningresultaat?
    Elk resultaat bevat sanctietreffers over elke grote bron, PEP-status met familie- en geassocieerdenconnecties, adverse media-treffers met meertalige bronvermeldingen, UBO-eigendomsgegevens, risiconiveauclassificatie en een bewijspakket met tijdstempel geschikt voor audit en toezichtbeoordeling.
    08Hoe lang duurt een screening?
    Een standaard sanctiecontrole is doorgaans in seconden afgerond. Een diepteonderzoekscreening — inclusief analyse van adverse media en eigendomsmapping — duurt gemiddeld minder dan twee minuten. Het asynchrone model zorgt ervoor dat uw systeem nooit wordt geblokkeerd in afwachting van resultaten.
    API-terminologie
    REST API
    Een web-API-architectuur die standaard HTTP-methoden (GET, POST, PUT, DELETE) gebruikt om met resources te communiceren. De API van ScreenVeritAI volgt REST-conventies, waardoor deze compatibel is met elke taal of elk framework dat HTTP-verzoeken kan doen.
    Webhook
    Een server-naar-server HTTP-callback die wordt geactiveerd door een event. In plaats van te pollen naar resultaten kunt u ScreenVeritAI configureren om een POST-verzoek naar uw endpoint te sturen wanneer een screening is afgerond of wanneer doorlopende monitoring een wijziging detecteert.
    Asynchrone verwerking
    Een verzoekmodel waarbij de API een taak direct accepteert en op de achtergrond verwerkt. De client ontvangt een taak-ID en haalt resultaten later op via polling of webhook. Dit patroon voorkomt blokkering in productie-pipelines.
    API-sleutel
    Een geheim token dat wordt gebruikt om server-naar-server API-verzoeken te authenticeren. ScreenVeritAI API-sleutels zijn voorzien van specifieke permissies (search:read, search:write, batch:read, batch:write) om least-privilege toegangspatronen af te dwingen.
    Rate limiting
    Een mechanisme dat het aantal API-verzoeken beperkt dat een client binnen een bepaald tijdsvenster kan doen. Rate limits worden toegewezen per abonnementsniveau en gecommuniceerd via response headers inclusief resterend quotum en reset-tijdstempels.
    Gestructureerde response
    Een machineleesbaar API-responseformaat (JSON) met consistente veldnamen, typen en nesting. Gestructureerde responses maken geautomatiseerde parsing, beslissingslogica en audittrail-generatie mogelijk zonder handmatige data-extractie.
    Sectorbronnen
    1. 01
    2. 02
      Regulatory Technology voor 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-witwasautoriteit (AMLA) Verordening

      Publicatieblad van de Europese Unie

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

    End of API specification.

    Begin binnen enkele minuten met screenen.

    Kies een plan en start vandaag nog met screenen.