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

    Obtenir une clé d'APIVoir les tarifs

    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

    Dé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

    Quatre é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 pour obtenir du JSON structuré — contexte de l'entreprise, actionnariat, PPE, médias défavorables, signaux de sanctions et scores de risque.

    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.

    Dé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://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 }
    Vérifier le résultat
    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 }

    Performance de l'API

    p. 08 / 09

    €0.39

    Quick Check par appel, sans frais de plateforme

    202

    Statut HTTP lorsqu'une recherche est acceptée ; le résultat est ensuite interrogé

    EU

    Hébergé en Finlande ; les données au repos restent dans l'UE

    FAQ — 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 X-API-Key. 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 ?
    Asynchrone. Soumettez une demande, recevez un identifiant de tâche, récupérez les résultats par interrogation. Votre pipeline ne se bloque jamais.
    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 ?
    Configurez la surveillance après le criblage initial. Lorsque les listes sont mises à jour ou que de nouveaux médias défavorables font surface, la surveillance signale le changement et vous alerte in-app.
    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.
    Traitement asynchrone
    L'API accepte la tâche immédiatement et la traite en arrière-plan — récupérez les résultats par interrogation.
    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
    En savoir plus

    Criblage des sanctions

    Criblez les entités sur chaque source majeure avec correspondance approximative et preuves de niveau coercitif.

    Criblage client et due diligence

    Allez au-delà des listes de sanctions — cartographiez l'actionnariat, l'exposition PPE et les médias défavorables pour des profils de risque complets.

    Criblage par lot

    Importez des fichiers CSV ou XLSX et vérifiez des centaines de clients, fournisseurs ou tiers en une seule tâche.

    Couverture des listes de sanctions

    Consultez chaque liste de sanctions, base PPE et juridiction couverte par ScreenVeritAI.

    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.

    Voir les tarifs