# 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 negatieve berichtgeving en 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 aanvragen Bekijk tarieven

// The request

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 "deep_research"

POST /v1/screenbash

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": "deep_research"

8 }'

POST /api/v1/screen — response200 OK

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

// The response

Structured JSON. Every risk vector. Color-coded.

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

// Endpoints

API Reference

Three endpoints cover all screening workflows.

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": "deep_research"}'

Response

200 OK

{ "request_id": "srv_a8f3c1d9", "status": "queued",

"estimated_seconds": 30, "poll_url": "/v1/result/srv_a8f3c1d9" }

// Integration patterns

Drop into your existing workflow

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

// Build vs buy

Zelf bouwen vs. kopen

Aspect	Zelf bouwen	ScreenVeritAI API
Tijd tot productie		Dagen om te integreren; productieklaar vanaf de eerste API-aanroep
Sanctielijstdekking		Meer dan 10 regimes continu onderhouden en bijgewerkt — OFAC, EU, VN, UK en meer
Matchingnauwkeurigheid		AI-agent met fuzzy matching, transliteratie, aliasresolutie en fonetische algoritmen
PEP en negatieve berichtgeving		PEP, negatieve berichtgeving en UBO-gegevens opgenomen in hetzelfde API-antwoord
Doorlopend onderhoud		Volledig beheerd — lijstupdates, modelverbeteringen en infrastructuur worden voor u afgehandeld
Auditspoor		Bewijspakketten met tijdstempel inclusief bronreferenties en besluitrationale inbegrepen

// How it works

Vier stappen naar productie

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.

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.

Resultaten verwerken

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

Monitoren en waarschuwen

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

// Quickstart examples

Binnen enkele minuten aan de slag

Eén API-aanroep retourneert een volledig screeningresultaat.

Een entiteit screenenbash

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 opvragenbash

bash

curl https://api.screenveritai.com/v1/results/RESULT_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

API-prestaties

10+

Wereldwijde sanctieregimes gescreend per API-aanroep

<2 min

Gemiddelde responstijd voor een volledige screening met diepteonderzoek

99.9%

API-uptime SLA voor productie-integraties

// FAQ

Veelgestelde vragen over API-integratie

#Hoe 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.

#Is 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.

#Welk responseformaat retourneert de API?

Alle responses zijn gestructureerde JSON met consistente veldnamen en typen. Screeningresultaten bevatten sanctietrefferdetails, PEP-signaleringen, treffers negatieve berichtgeving, betrouwbaarheidsscores, bronreferenties en risiconiveauclassificatie — klaar voor geautomatiseerde parsing en beslissingslogica zonder handmatige extractie.

#Welke 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.

#Kan 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.

#Hoe 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 negatieve berichtgeving opduikt, stuurt de API een webhook-melding naar uw geconfigureerde endpoint zodat uw systeem automatisch herscreening of escalatie kan triggeren.

#Welke compliancegegevens zijn opgenomen in elk screeningresultaat?

Elk resultaat bevat sanctietreffers over meer dan 10 regimes, PEP-status met familie- en geassocieerdenconnecties, treffers negatieve berichtgeving met meertalige bronvermeldingen, UBO-eigendomsgegevens, risiconiveauclassificatie en een bewijspakket met tijdstempel geschikt voor audit en toezichtbeoordeling.

#Hoe lang duurt een screening?

Een standaard sanctiecontrole is doorgaans in seconden afgerond. Een diepteonderzoekscreening — inclusief analyse van negatieve berichtgeving 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]
FATF-richtlijn over digitale identiteit en cliëntenonderzoek
Financial Action Task Force
[2]
Regulatory Technology voor AML/CFT-compliance
Bank for International Settlements — FSI Insights
[3]
OFAC Compliance Commitments Framework
U.S. Department of the Treasury
[4]
EU Anti-witwasautoriteit (AMLA) Verordening
Publicatieblad van de Europese Unie

Integreer compliancescreening in elke workflow

One POST call. That's your entire integration.

Structured JSON. Every risk vector. Color-coded.

API Reference

Drop into your existing workflow

Zelf bouwen vs. kopen

Vier stappen naar productie

Binnen enkele minuten aan de slag

API-prestaties

Veelgestelde vragen over API-integratie

API-terminologie

/* Sectorbronnen */

// Ontdek meer

Sanctiescreening

Klantscreening & due diligence

Batchscreening

Sanctielijstdekking

Begin met screenen in minuten.