ScreenVeritAI
    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.

    API-sleutel aanvragenBekijk tarieven

    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

    Zelf 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

    Vier 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 voor gestructureerde JSON — bedrijfscontext, eigendom, PEP, adverse media, sanctiesignalen en risicoscores.

    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.

    Binnen enkele minuten aan de slag

    p. 07 / 09

    Eén API-aanroep retourneert een volledig screeningresultaat.

    Een entiteit screenen
    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 }
    Resultaat opvragen
    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 }

    API-prestaties

    p. 08 / 09

    €0.39

    Quick Check per aanroep, geen platformkosten

    202

    HTTP-status wanneer een zoekopdracht is geaccepteerd; daarna haalt u het resultaat op

    EU

    Gehost in Finland; data in rust blijft in de EU

    Veelgestelde 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 X-API-Key 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?
    Asynchroon. U dient een verzoek in, ontvangt een taak-ID en haalt de resultaten op via polling. Uw pipeline blokkeert nooit.
    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?
    Configureer monitoring na een initiële screening. Wanneer lijsten worden bijgewerkt of nieuwe adverse media opduikt, signaleert monitoring de wijziging en krijgt u een melding in de app.
    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.
    Asynchrone verwerking
    De API accepteert een taak direct en verwerkt die op de achtergrond — haal de resultaten op via polling.
    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

    Ontdek meer

    Sanctiescreening

    Screen entiteiten tegen elke grote bron met fuzzy matching en handhavingswaardig bewijs.

    Klantscreening & due diligence

    Ga verder dan sanctielijsten — breng eigendom, PEP-blootstelling en adverse media in kaart voor volledige risicoprofielen.

    Batchscreening

    Upload CSV- of XLSX-bestanden en screen honderden entiteiten tegen alle sanctieregimes in één taak.

    Sanctielijstdekking

    Bekijk elke sanctielijst, PEP-database en elk rechtsgebied dat ScreenVeritAI dekt.

    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.

    Bekijk prijzen