ScreenVeritAI · API Specv1 · GA · reference
    Developer API

    Warum Namen zwischen Systemen kopieren, wenn ein API-Aufruf alles erledigt?

    Betten Sie Firmenverifizierung, die Abbildung der Eigentümerstruktur, PEP-Checks, Adverse Media (belastende Medienberichte) und Sanktionssignale direkt in Ihre bestehenden Workflows ein.

    §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

    §05Selbst entwickeln vs. ScreenVeritAI integrieren

    p. 05 / 09
    Zeit bis zur Produktion
    Eigenentwicklung
    6–12 Monate, um Listen zu beschaffen, das Matching zu bauen und Sonderfälle abzudecken
    ScreenVeritAI-API
    Tage bis zur Integration — produktionsreif ab dem ersten API-Aufruf
    Sanktionslistenabdeckung
    Eigenentwicklung
    Manuelle Einbindung jedes Listenformats; laufende Pflege bei Schemaänderungen
    ScreenVeritAI-API
    Jede wichtige Quelle, kontinuierlich gepflegt und aktualisiert
    Matching-Genauigkeit
    Eigenentwicklung
    Eigenes Fuzzy-Matching erfordert NLP-Know-how und ständiges Nachjustieren
    ScreenVeritAI-API
    KI mit Fuzzy-Matching, Transliteration, Alias-Auflösung und phonetischen Algorithmen
    PEP und Adverse Media
    Eigenentwicklung
    Getrennte Anbieter, getrennte Integrationen, getrennte Budgets
    ScreenVeritAI-API
    PEP, Adverse Media und UBO-Daten in derselben API-Antwort
    Laufende Wartung
    Eigenentwicklung
    Eigenes Team für Listen-Updates, Schemaänderungen und das Nachjustieren von Fehlalarmen
    ScreenVeritAI-API
    Vollständig verwaltet — Updates, Verbesserungen und Infrastruktur übernehmen wir für Sie
    Prüfpfad
    Eigenentwicklung
    Eigene Infrastruktur für Logging, Nachweise und Aufbewahrung aufbauen
    ScreenVeritAI-API
    Revisionssichere Nachweispakete mit Quellenangaben inklusive

    §06In vier Schritten zu eingebetteter Compliance

    p. 06 / 09
    1

    API-Schlüssel erstellen

    Erstellen Sie im Dashboard einen Schlüssel mit eingegrenztem Berechtigungsumfang nach dem Least-Privilege-Prinzip: search:read, search:write, batch:read, batch:write.

    2

    Endpoint integrieren

    Ein einziger POST-Aufruf in Ihrem Onboarding-, Zahlungs- oder CRM-Workflow — senden Sie Name, Typ und Land und erhalten eine Job-ID zurück.

    3

    Ergebnisse verarbeiten

    Fragen Sie den Ergebnis-Endpoint per Polling ab oder empfangen Sie einen Webhook-Callback mit strukturiertem JSON — Unternehmenskontext, Eigentümerstruktur, PEP, Adverse Media, Sanktionssignale und Risikoscores.

    4

    Überwachen und benachrichtigen

    Richten Sie kontinuierliches Monitoring ein — die API benachrichtigt Sie, sobald Sanktionslisten aktualisiert werden oder neue Adverse Media auftauchen.

    §07In wenigen Minuten startklar

    p. 07 / 09

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

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

    §08API-Leistung

    p. 08 / 09

    Alle

    Wichtige Quellen 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

    §09FAQ zur API-Integration

    p. 09 / 09
    01Wie authentifiziere ich API-Anfragen?
    Authentifizieren Sie API-Anfragen mit einem geheimen Schlüssel im Authorization-Header. Schlüssel erstellen Sie in Ihrem Dashboard mit gezielt eingegrenzten Berechtigungen.
    02Ist die API synchron oder asynchron?
    Asynchron. Sie senden eine Anfrage, erhalten eine Job-ID und rufen die Ergebnisse per Polling oder Webhook ab. Ihre Pipeline wird nie blockiert.
    03Welches Antwortformat liefert die API?
    Strukturiertes JSON mit Sanktionstreffern, PEP-Kennzeichnungen, Adverse Media, Konfidenzwerten, Quellenangaben und einer Einstufung der Risikoklasse.
    04Welche Rate-Limits gelten?
    Sie werden je Tarifstufe und pro API-Schlüssel vergeben. Die Antwort-Header enthalten das verbleibende Kontingent und den Reset-Zeitstempel.
    05Kann ich Entitäten per API im Batch prüfen?
    Ja. Der Batch-Endpoint akzeptiert CSV- oder XLSX-Dateien mit bis zu 100 Zeilen pro Anfrage; die Ergebnisse rufen Sie pro Zeile oder als vollständigen Export ab.
    06Wie richte ich laufendes Monitoring per API ein?
    Konfigurieren Sie das Monitoring nach dem ersten Screening. Sobald Listen aktualisiert werden oder neue Adverse Media auftauchen, sendet die API einen Webhook an Ihren Endpoint.
    07Welche Compliance-Daten enthält jedes Screening-Ergebnis?
    Sanktionstreffer über jede wichtige Quelle, PEP-Status samt Familienverbindungen, Adverse Media mit mehrsprachigen Quellenangaben, UBO-Daten, Risikoklasse und ein revisionssicheres Nachweispaket zum Prüfzeitpunkt.
    08Wie lange dauert ein Screening?
    Eine Standard-Sanktionsprüfung: Sekunden. Eine Tiefenrecherche mit Adverse Media und Abbildung der Eigentümerstruktur: unter zwei Minuten.
    API-Terminologie
    REST-API
    Web-API auf Basis der Standard-HTTP-Methoden — kompatibel mit jeder Sprache und jedem Framework, das HTTP-Anfragen stellen kann.
    Webhook
    Server-zu-Server-HTTP-Callback, der ausgelöst wird, sobald ein Screening abgeschlossen ist oder das Monitoring eine Änderung erkennt.
    Asynchrone Verarbeitung
    Die API nimmt einen Auftrag sofort an und verarbeitet ihn im Hintergrund — Ergebnisse rufen Sie per Polling oder Webhook ab.
    API-Schlüssel
    Geheimes Token zur Authentifizierung von API-Anfragen, mit gezielten Berechtigungen nach dem Least-Privilege-Prinzip versehen.
    Rate-Limiting
    Begrenzt die Zahl der API-Anfragen pro Zeitfenster je nach Tarifstufe — verbleibendes Kontingent und Reset-Zeitstempel stehen in den Antwort-Headern.
    Strukturierte Antwort
    Maschinenlesbares JSON mit einheitlichen Feldnamen und Typen — ermöglicht automatisches Parsen und Entscheidungslogik.
    Branchenquellen
    1. 01
    2. 02
      Regulierungstechnologie für AML/CFT-Compliance

      Bank für Internationalen Zahlungsausgleich — FSI Insights

    3. 03
    4. 04
    chk api-v1svai-api-specv1 · ga2 samples · reference

    End of API specification.

    In wenigen Minuten startklar.

    Tarif wählen und noch heute mit dem Screening beginnen.