# API développeur

Intégrez le filtrage de conformité dans n'importe quel processus

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 filtrage des sanctions, les vérifications PPE, l'analyse des médias défavorables et la cartographie des bénéficiaires effectifs directement dans ces processus — sans recherches manuelles, sans copier-coller, sans lacunes de conformité entre les systèmes. Un seul appel API déclenche le même agent IA qui alimente notre plateforme, et un JSON structuré est renvoyé, prêt pour votre moteur de décision.

Obtenir une clé API Voir les tarifs

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

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

Développer en interne vs acheter

Aspect	Développement interne	API ScreenVeritAI
Délai de mise en production
Couverture des listes de sanctions
Précision de correspondance
PPE et médias défavorables
Maintenance continue
Piste d'audit

// How it works

Quatre étapes vers la production

Obtenir votre clé API

Créez une clé API avec des permissions définies depuis votre tableau de bord ScreenVeritAI. Attribuez les permissions — search:read, search:write, batch:read, batch:write — pour un accès au moindre privilège.

Intégrer le point d'accès

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.

Traiter les résultats

Interrogez le point d'accès des 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.

Surveiller et alerter

Configurez la surveillance continue pour les entités filtré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 refiltrage automatiquement.

// Quickstart examples

Démarrez en quelques minutes

Un seul appel API renvoie un résultat de filtrage complet.

Filtrer une entitébash

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

bash

curl https://api.screenveritai.com/v1/results/RESULT_ID \
  -H 'Authorization: Bearer YOUR_API_KEY'

Performance de l'API

10+

Régimes de sanctions mondiaux filtrés par appel API

<2 min

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

99.9%

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

// FAQ

FAQ — Intégration API

#Comment authentifier les requêtes API ?

Toutes les requêtes API sont authentifiées à l'aide d'une clé 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 au moindre privilège.

#L'API est-elle synchrone ou asynchrone ?

L'API utilise un modèle de traitement asynchrone. Vous soumettez une demande de filtrage via POST et recevez un identifiant de tâche immédiatement. Les résultats sont récupérés en interrogeant le point d'accès des résultats ou en configurant un rappel webhook. Cela évite le blocage dans votre pipeline de production pendant que l'agent IA termine son analyse.

#Quel 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 filtrage 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.

#Quelles limites de débit s'appliquent ?

Les limites de débit sont attribuées par niveau d'abonnement et appliquées par clé 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, le point d'accès par lots accepte des téléchargements CSV/XLSX pour le filtrage à haut volume.

#Puis-je filtrer des entités par lots via l'API ?

Oui. Le point d'accès par lots accepte des fichiers CSV ou XLSX jusqu'à 100 lignes par requête. Chaque ligne est traitée comme un filtrage 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.

#Comment configurer la surveillance continue via l'API ?

Après un filtrage initial, vous pouvez configurer la surveillance pour l'entité filtré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 point d'accès configuré pour que votre système puisse déclencher automatiquement un refiltrage ou une escalade.

#Quelles données de conformité sont incluses dans chaque résultat de filtrage ?

Chaque résultat inclut les correspondances de sanctions sur plus de 10 régimes, le statut PPE avec les connexions familiales et d'associés, les médias défavorables avec citations de sources multilingues, les données de propriété des bénéficiaires effectifs, la classification par niveau de risque et un dossier de preuves horodaté adapté à l'audit et à l'examen réglementaire.

#Combien de temps dure un filtrage ?

Une vérification de sanctions standard se termine généralement en quelques secondes. Un filtrage avec recherche approfondie — incluant l'analyse des médias défavorables et la cartographie de propriété — 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 architecture d'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, la rendant 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 point d'accès lorsqu'un filtrage est terminé 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é API

Un jeton secret utilisé pour authentifier les requêtes API serveur-à-serveur. Les clés 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 au moindre privilège.

Limitation 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 niveau 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]
Guide du GAFI sur l'identité numérique et le devoir de vigilance relatif à la clientèle
Groupe d'action financière (GAFI)
[2]
Technologies réglementaires pour la conformité LCB-FT
Banque des règlements internationaux — FSI Insights
[3]
Cadre d'engagements de conformité OFAC
Département du Trésor des États-Unis
[4]
Règlement sur l'Autorité européenne de lutte contre le blanchiment (AMLA)
Journal officiel de l'Union européenne

Intégrez le filtrage de conformité dans n'importe quel processus

One POST call. That's your entire integration.

Structured JSON. Every risk vector. Color-coded.

API Reference

Drop into your existing workflow

Développer en interne vs acheter

Quatre étapes vers la production

Démarrez en quelques minutes

Performance de l'API

FAQ — Intégration API

Terminologie API

/* Sources sectorielles */

// En savoir plus

Filtrage des sanctions

Filtrage client et due diligence

Filtrage par lots

Couverture des listes de sanctions

Commencez la vérification en quelques minutes.