ScreenVeritAI · API Specv1 · GA · reference
    API développeur

    Pourquoi copier-coller des noms entre vos systèmes quand un seul appel d'API suffit ?

    Votre pipeline d'entrée en relation, votre passerelle de paiement et votre CRM prennent déjà des décisions de risque chaque jour. L'API de ScreenVeritAI vous permet d'intégrer le criblage des sanctions, les contrôles PPE, l'analyse des médias défavorables et la cartographie de l'actionnariat directement dans ces processus — sans recherches manuelles, sans copier-coller, sans lacunes de conformité entre les systèmes. Un seul appel d'API déclenche le même moteur qui alimente notre plateforme, et un JSON structuré est renvoyé, prêt pour votre moteur de décision.

    §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

    §05Développer en interne vs intégrer ScreenVeritAI

    p. 05 / 09
    Délai de mise en production
    Développement interne
    6 à 12 mois pour sourcer les listes, construire la correspondance et gérer les cas limites
    API ScreenVeritAI
    Quelques jours d'intégration ; opérationnel dès le premier appel d'API
    Couverture des listes de sanctions
    Développement interne
    Ingestion manuelle de chaque format de liste ; maintenance continue lors des changements de schéma
    API ScreenVeritAI
    Chaque source majeure, maintenue et mise à jour en continu
    Précision de la correspondance
    Développement interne
    La correspondance approximative sur mesure exige une expertise NLP et un réglage constant
    API ScreenVeritAI
    IA avec correspondance approximative, translittération, résolution d'alias et algorithmes phonétiques
    PPE et médias défavorables
    Développement interne
    Fournisseurs de données séparés, intégrations séparées, budgets séparés
    API ScreenVeritAI
    PPE, médias défavorables et données de bénéficiaires effectifs dans la même réponse d'API
    Maintenance continue
    Développement interne
    Équipe dédiée aux mises à jour de listes, aux changements de schéma et au réglage des faux positifs
    API ScreenVeritAI
    Entièrement géré — mises à jour, améliorations et infrastructure prises en charge pour vous
    Piste d'audit
    Développement interne
    Construire votre propre infrastructure de journalisation, de preuves et de conservation
    API ScreenVeritAI
    Dossiers de preuves horodatés avec références de sources inclus

    §06Quatre étapes vers la production

    p. 06 / 09
    1

    Obtenir votre clé d'API

    Créez une clé d'API à portée définie depuis votre tableau de bord ScreenVeritAI. Attribuez les permissions — search:read, search:write, batch:read, batch:write — pour un accès à moindre privilège.

    2

    Intégrer l'endpoint

    Ajoutez un seul appel POST à votre processus d'entrée en relation, de paiement ou CRM. Envoyez le nom de l'entité, le type et le pays. L'API renvoie un identifiant de tâche pour la récupération asynchrone des résultats.

    3

    Traiter les résultats

    Interrogez l'endpoint de résultats ou recevez un rappel webhook. Analysez la réponse JSON structurée — correspondances de sanctions, signalements PPE, médias défavorables et scores de risque — et routez vers votre logique de décision.

    4

    Surveiller et alerter

    Configurez la surveillance continue pour les entités criblées. Lorsque les listes de sanctions sont mises à jour ou que de nouveaux médias défavorables font surface, l'API envoie des alertes pour que votre système puisse déclencher un recriblage automatiquement.

    §07Démarrez en quelques minutes

    p. 07 / 09

    Un seul appel d'API renvoie un résultat de criblage complet.

    Cribler une entité
    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"}'
    Vérifier le résultat
    bash
    curl https://api.screenveritai.com/v1/results/RESULT_ID \
      -H 'Authorization: Bearer YOUR_API_KEY'

    §08Performance de l'API

    p. 08 / 09

    Toutes

    Sources majeures criblées par appel d'API

    <2 min

    Temps de réponse moyen pour un criblage complet avec recherche approfondie

    99.9%

    SLA de disponibilité de l'API pour les intégrations de production

    §09FAQ — Intégration API

    p. 09 / 09
    01Comment authentifier les requêtes API ?
    Toutes les requêtes API sont authentifiées à l'aide d'une clé d'API transmise dans l'en-tête Authorization. Les clés sont créées depuis votre tableau de bord ScreenVeritAI avec des permissions définies (search:read, search:write, batch:read, batch:write) pour appliquer un accès à moindre privilège.
    02L'API est-elle synchrone ou asynchrone ?
    L'API utilise un modèle de traitement asynchrone. Vous soumettez une demande de criblage via POST et recevez un identifiant de tâche immédiatement. Les résultats se récupèrent en interrogeant l'endpoint de résultats ou via un rappel webhook. Cela évite le blocage dans votre pipeline de production pendant que l'analyse se termine.
    03Quel format de réponse l'API renvoie-t-elle ?
    Toutes les réponses sont en JSON structuré avec des noms de champs et types cohérents. Les résultats de criblage incluent les détails des correspondances de sanctions, les signalements PPE, les médias défavorables, les scores de confiance, les références de sources et la classification par niveau de risque — prêts pour l'analyse automatisée et la logique de décision sans extraction manuelle.
    04Quelles limites de débit s'appliquent ?
    Les limites de débit sont attribuées par palier d'abonnement et appliquées par clé d'API. Les en-têtes de réponse incluent votre limite actuelle, le quota restant et l'horodatage de réinitialisation. Si vous avez besoin d'un débit plus élevé pour le traitement en masse, l'endpoint de lots accepte des imports CSV/XLSX pour le criblage à haut volume.
    05Puis-je cribler des entités par lot via l'API ?
    Oui. L'endpoint de lots accepte des fichiers CSV ou XLSX jusqu'à 100 lignes par requête. Chaque ligne est traitée comme un criblage individuel, et les résultats sont récupérables par ligne ou sous forme d'export complet téléchargeable lorsque la tâche est terminée.
    06Comment configurer la surveillance continue via l'API ?
    Après un criblage initial, vous pouvez configurer la surveillance de l'entité criblée. Lorsque les listes de sanctions sont mises à jour ou que de nouveaux médias défavorables font surface, l'API envoie une notification webhook à votre endpoint configuré pour que votre système puisse déclencher automatiquement un recriblage ou une escalade.
    07Quelles données de conformité sont incluses dans chaque résultat de criblage ?
    Chaque résultat inclut les correspondances de sanctions sur chaque source majeure, le statut PPE avec les connexions familiales et d'associés, les médias défavorables avec citations de sources multilingues, les données d'actionnariat (bénéficiaires effectifs), la classification par niveau de risque et un dossier de preuves horodaté adapté à l'audit et à l'examen réglementaire.
    08Combien de temps dure un criblage ?
    Une vérification de sanctions standard se termine généralement en quelques secondes. Un criblage avec recherche approfondie — incluant l'analyse des médias défavorables et la cartographie de l'actionnariat — prend en moyenne moins de deux minutes. Le modèle asynchrone garantit que votre système n'est jamais bloqué en attendant les résultats.
    Terminologie API
    API REST
    Une API web qui utilise les méthodes HTTP standard (GET, POST, PUT, DELETE) pour interagir avec les ressources. L'API de ScreenVeritAI suit les conventions REST, ce qui la rend compatible avec tout langage ou framework capable d'effectuer des requêtes HTTP.
    Webhook
    Un rappel HTTP serveur à serveur déclenché par un événement. Au lieu d'interroger les résultats, vous pouvez configurer ScreenVeritAI pour envoyer une requête POST à votre endpoint lorsqu'un criblage se termine ou lorsque la surveillance continue détecte un changement.
    Traitement asynchrone
    Un modèle de requête dans lequel l'API accepte une tâche immédiatement et la traite en arrière-plan. Le client reçoit un identifiant de tâche et récupère les résultats ultérieurement via interrogation ou webhook. Ce modèle évite le blocage dans les pipelines de production.
    Clé d'API
    Un jeton secret utilisé pour authentifier les requêtes API serveur à serveur. Les clés d'API de ScreenVeritAI sont dotées de permissions spécifiques (search:read, search:write, batch:read, batch:write) pour appliquer des modèles d'accès à moindre privilège.
    Limite de débit
    Un mécanisme qui restreint le nombre de requêtes API qu'un client peut effectuer dans une fenêtre de temps donnée. Les limites de débit sont attribuées par palier d'abonnement et communiquées via les en-têtes de réponse incluant le quota restant et les horodatages de réinitialisation.
    Réponse structurée
    Un format de réponse API lisible par machine (JSON) avec des noms de champs, types et imbrications cohérents. Les réponses structurées permettent l'analyse automatisée, la logique de décision et la génération de pistes d'audit sans extraction manuelle de données.
    Sources sectorielles
    1. 01
    2. 02
      Technologies réglementaires pour la conformité LCB-FT

      Banque des règlements internationaux — FSI Insights

    3. 03
      Cadre d'engagements de conformité de l'OFAC

      Département du Trésor des États-Unis

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

    End of API specification.

    Commencez à cribler en quelques minutes.

    Choisissez une formule et lancez votre premier criblage dès aujourd'hui.