# Entwickler-API

    Integrieren Sie Compliance-Screening in jeden Workflow

    $

    Ihre Onboarding-Pipeline, Ihr Zahlungsgateway und Ihr CRM treffen bereits täglich Risikoentscheidungen. Die API von ScreenVeritAI ermöglicht es Ihnen, Sanktionsprüfung, PEP-Checks, negative Medienanalyse und UBO-Kartierung direkt in diese Workflows einzubetten — keine manuellen Abfragen, kein Kopieren und Einfügen, keine Compliance-Lücken zwischen Systemen. Ein einziger API-Aufruf startet denselben KI-Agenten, der unsere Plattform antreibt, und strukturiertes JSON kommt zurück, bereit für Ihre Entscheidungslogik.

    // 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
    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

    // 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

    Selbst entwickeln vs. kaufen

    AspektEigenentwicklungScreenVeritAI-API

    // How it works

    Vier Schritte bis zur Produktion

    1

    API-Schlüssel erhalten

    Erstellen Sie einen berechtigungsbegrenzten API-Schlüssel über Ihr ScreenVeritAI-Dashboard. Weisen Sie Berechtigungen zu — search:read, search:write, batch:read, batch:write — für einen Zugriff mit minimalen Rechten.

    2

    Endpunkt integrieren

    Fügen Sie einen einzigen POST-Aufruf zu Ihrem Onboarding-, Zahlungs- oder CRM-Workflow hinzu. Senden Sie den Entitätsnamen, Typ und Land. Die API gibt eine Job-ID für den asynchronen Ergebnisabruf zurück.

    3

    Ergebnisse verarbeiten

    Fragen Sie den Ergebnis-Endpunkt ab oder empfangen Sie einen Webhook-Callback. Parsen Sie die strukturierte JSON-Antwort — Sanktionstreffer, PEP-Kennzeichnungen, negative Medienbefunde und Risikoscores — und leiten Sie sie an Ihre Entscheidungslogik weiter.

    4

    Überwachen und benachrichtigen

    Konfigurieren Sie die laufende Überwachung für geprüfte Entitäten. Wenn Sanktionslisten aktualisiert werden oder neue negative Medienberichte auftauchen, sendet die API Benachrichtigungen, damit Ihr System automatisch eine Neuprüfung auslösen kann.

    // Quickstart examples

    Starten Sie in Minuten

    Ein einziger API-Aufruf liefert ein vollständiges Screening-Ergebnis.

    Entität prüfenbash
    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"}'
    Ergebnis abrufenbash
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    API-Leistung

    10+

    Globale Sanktionsregime pro API-Aufruf geprüft

    <2 min

    Durchschnittliche Antwortzeit für ein vollständiges Screening mit Tiefenrecherche

    99.9%

    API-Verfügbarkeits-SLA für Produktionsintegrationen

    // FAQ

    FAQ zur API-Integration

    #Wie authentifiziere ich API-Anfragen?
    Alle API-Anfragen werden mit einem API-Schlüssel authentifiziert, der im Authorization-Header übergeben wird. Schlüssel werden über Ihr ScreenVeritAI-Dashboard mit berechtigungsbegrenzten Zugriffsrechten erstellt (search:read, search:write, batch:read, batch:write), um einen Zugriff mit minimalen Rechten durchzusetzen.
    #Ist die API synchron oder asynchron?
    Die API verwendet ein asynchrones Verarbeitungsmodell. Sie reichen eine Screening-Anfrage per POST ein und erhalten sofort eine Job-ID. Ergebnisse werden durch Abfrage des Ergebnis-Endpunkts oder durch Konfiguration eines Webhook-Callbacks abgerufen. Dies verhindert Blockierungen in Ihrer Produktionspipeline, während der KI-Agent seine Analyse abschließt.
    #Welches Antwortformat gibt die API zurück?
    Alle Antworten sind strukturiertes JSON mit konsistenten Feldnamen und Typen. Screening-Ergebnisse umfassen Sanktionstreffer-Details, PEP-Kennzeichnungen, negative Medienbefunde, Konfidenzwerte, Quellenreferenzen und Risikostufen-Klassifizierung — bereit für automatisches Parsen und Entscheidungslogik ohne manuelle Extraktion.
    #Welche Ratenbegrenzungen gelten?
    Ratenbegrenzungen werden nach Abonnement-Stufe zugewiesen und pro API-Schlüssel durchgesetzt. Antwort-Header enthalten Ihr aktuelles Limit, verbleibendes Kontingent und Zurücksetzungszeitstempel. Wenn Sie höheren Durchsatz für Massenverarbeitung benötigen, akzeptiert der Stapel-Endpunkt CSV/XLSX-Uploads für Hochvolumen-Screening.
    #Kann ich Entitäten per API im Stapelverfahren prüfen?
    Ja. Der Stapel-Endpunkt akzeptiert CSV- oder XLSX-Dateien mit bis zu 100 Zeilen pro Anfrage. Jede Zeile wird als einzelnes Screening verarbeitet, und Ergebnisse sind pro Zeile oder als vollständiger herunterladbarer Export abrufbar, wenn der Auftrag abgeschlossen ist.
    #Wie richte ich die laufende Überwachung per API ein?
    Nach einem ersten Screening können Sie die Überwachung für die geprüfte Entität konfigurieren. Wenn Sanktionslisten aktualisiert werden oder neue negative Medienberichte auftauchen, sendet die API eine Webhook-Benachrichtigung an Ihren konfigurierten Endpunkt, damit Ihr System automatisch eine Neuprüfung oder Eskalation auslösen kann.
    #Welche Compliance-Daten sind in jedem Screening-Ergebnis enthalten?
    Jedes Ergebnis umfasst Sanktionstreffer über mehr als 10 Regime, PEP-Status mit Familien- und Geschäftspartnerverbindungen, negative Medienbefunde mit mehrsprachigen Quellenangaben, UBO-Eigentümerdaten, Risikostufen-Klassifizierung und ein zeitgestempeltes Nachweispaket für Prüfungen und behördliche Überprüfungen.
    #Wie lange dauert ein Screening?
    Eine Standard-Sanktionsprüfung wird typischerweise in Sekunden abgeschlossen. Ein Tiefenrecherche-Screening — einschließlich negativer Medienanalyse und Eigentümerkartierung — dauert durchschnittlich unter zwei Minuten. Das asynchrone Modell bedeutet, dass Ihr System nie auf Ergebnisse warten muss.

    API-Terminologie

    REST-API
    Eine Web-API-Architektur, die Standard-HTTP-Methoden (GET, POST, PUT, DELETE) zur Interaktion mit Ressourcen verwendet. Die API von ScreenVeritAI folgt REST-Konventionen und ist mit jeder Programmiersprache oder jedem Framework kompatibel, das HTTP-Anfragen stellen kann.
    Webhook
    Ein Server-zu-Server-HTTP-Callback, der durch ein Ereignis ausgelöst wird. Anstatt Ergebnisse abzufragen, können Sie ScreenVeritAI so konfigurieren, dass eine POST-Anfrage an Ihren Endpunkt gesendet wird, wenn ein Screening abgeschlossen ist oder wenn die laufende Überwachung eine Änderung erkennt.
    Asynchrone Verarbeitung
    Ein Anfragemodell, bei dem die API einen Auftrag sofort annimmt und im Hintergrund verarbeitet. Der Client erhält eine Job-ID und ruft Ergebnisse später per Polling oder Webhook ab. Dieses Muster verhindert Blockierungen in Produktionspipelines.
    API-Schlüssel
    Ein geheimes Token zur Authentifizierung von Server-zu-Server-API-Anfragen. ScreenVeritAI-API-Schlüssel werden mit bestimmten Berechtigungen (search:read, search:write, batch:read, batch:write) versehen, um Zugriffsmuster mit minimalen Rechten durchzusetzen.
    Ratenbegrenzung
    Ein Mechanismus, der die Anzahl der API-Anfragen begrenzt, die ein Client innerhalb eines bestimmten Zeitfensters stellen kann. Ratenbegrenzungen werden nach Abonnement-Stufe zugewiesen und über Antwort-Header kommuniziert, einschließlich verbleibendem Kontingent und Zurücksetzungszeitstempeln.
    Strukturierte Antwort
    Ein maschinenlesbares API-Antwortformat (JSON) mit konsistenten Feldnamen, Typen und Verschachtelung. Strukturierte Antworten ermöglichen automatisches Parsen, Entscheidungslogik und Prüfpfad-Generierung ohne manuelle Datenextraktion.

    /* Branchenquellen */

    1. [1]
    2. [2]
      Regulierungstechnologie für AML/CFT-Compliance

      Bank für Internationalen Zahlungsausgleich — FSI Insights

    3. [3]
    4. [4]

    Starten Sie die Prüfung in Minuten.

    Keine Kreditkarte erforderlich.