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

    API-Schlüssel holenPreise ansehen

    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

    Selbst 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

    In 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 und erhalten Sie strukturiertes JSON — Unternehmenskontext, Eigentümerstruktur, PEP, Adverse Media, Sanktionssignale und Risiko-Scores.

    4

    Überwachen und benachrichtigen

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

    In 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://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 }
    Ergebnis abrufen
    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-Leistung

    p. 08 / 09

    €0.39

    Quick Check pro Aufruf, keine Plattformgebühr

    202

    HTTP-Status bei angenommener Suche; das Ergebnis wird per Polling abgeholt

    EU

    Gehostet in Finnland; ruhende Daten bleiben in der EU

    FAQ zur API-Integration

    p. 09 / 09
    01Wie authentifiziere ich API-Anfragen?
    Authentifizieren Sie API-Anfragen mit einem geheimen Schlüssel im X-API-Key-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 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, markiert das Monitoring die Änderung und benachrichtigt Sie in der App.
    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.
    Asynchrone Verarbeitung
    Die API nimmt einen Auftrag sofort an und verarbeitet ihn im Hintergrund — Ergebnisse rufen Sie per Polling 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
    Mehr entdecken

    Sanktionsprüfung

    Prüfen Sie Personen und Unternehmen gegen jede wichtige Quelle — mit Fuzzy-Matching und durchsetzungsfähigen Nachweisen.

    Kundenprüfung & Sorgfaltspflicht

    Bilden Sie Eigentümerstruktur, PEP-Exposition, Adverse Media und Sanktionssignale zu vollständigen Gegenpartei-Risikoprofilen ab.

    Batch-Screening

    Laden Sie CSV- oder XLSX-Dateien hoch und prüfen Sie Hunderte Kunden, Lieferanten oder Dienstleister in einem Auftrag.

    Sanktionslisten-Abdeckung

    Sehen Sie jede Sanktionsliste, PEP-Datenbank und Jurisdiktion, die ScreenVeritAI abdeckt.

    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.

    Preise ansehen