API Email Risk : Délivrabilité et signaux de fuite

curl

curl -X POST https://verification.didit.me/v3/email/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "alice@example.com",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Email.AssessRisk(ctx, didit.EmailRiskRequest{
	Email: "alice@example.com",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.EmailRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.email().assessRisk(EmailRiskRequest.builder()
        .email("alice@example.com")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->email->assessRisk([
    'email' => 'alice@example.com',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Email.AssessRiskAsync(new EmailRiskRequest
{
    Email = "alice@example.com",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "82397be9-5921-4970-a979-2d5b43e08b33",
  "status": "Approved",
  "email": {
    "status": "Approved",
    "email": "alice@example.com",
    "is_breached": false,
    "breaches": [],
    "is_disposable": false,
    "is_undeliverable": false,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "email_intelligence": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    },
    "enrichment": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

POST

risk

curl

curl -X POST https://verification.didit.me/v3/email/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "alice@example.com",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Email.AssessRisk(ctx, didit.EmailRiskRequest{
	Email: "alice@example.com",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.EmailRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.email().assessRisk(EmailRiskRequest.builder()
        .email("alice@example.com")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->email->assessRisk([
    'email' => 'alice@example.com',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Email.AssessRiskAsync(new EmailRiskRequest
{
    Email = "alice@example.com",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "82397be9-5921-4970-a979-2d5b43e08b33",
  "status": "Approved",
  "email": {
    "status": "Approved",
    "email": "alice@example.com",
    "is_breached": false,
    "breaches": [],
    "is_disposable": false,
    "is_undeliverable": false,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "email_intelligence": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    },
    "enrichment": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

Utilisez POST /v3/email/risk/ lorsque vous avez besoin d’informations sur l’e-mail sans demander à l’utilisateur de saisir un code à usage unique. Il n’envoie aucun e-mail. Il crée une session d’API, enrichit l’adresse, applique vos règles de risque lié à l’e-mail et renvoie, dans une seule réponse synchrone, le même bloc d’e-mail normalisé que celui utilisé par la Vérification de l’e-mail. Lorsque la requête est enregistrée, Didit peut également utiliser l’e-mail évalué comme preuve agrégée dans Réseaux. Les graphes de réseau peuvent afficher des informations d’e-mail à haut risque, le contexte des fuites de données et la couverture des profils sociaux pour les signaux d’e-mail partagés, mais ils ne révèlent pas l’adresse e-mail brute aux autres organisations.

Interpréter la réponse

status correspond à la décision finale pour cette session d’API. Il vaut généralement Approved ; l’évaluation du risque peut produire In Review ou Declined.
email.is_breached, email.is_disposable et email.is_undeliverable sont des indicateurs oui/non stables, à utiliser dans la logique de votre application.
email.breaches liste les fuites de données connues les plus récentes contenant l’adresse, lorsque la couverture est disponible, avec la date de la fuite et les catégories de données exposées.
email.email_intelligence.score utilise une échelle de risque de 0 à 100, où un nombre plus élevé indique un risque plus élevé. breach_risk_level (Low, Medium, High) et no_of_breaches sont des valeurs dérivées.
email.email_intelligence.reason_codes explique quels signaux normalisés ont contribué au résultat. Ces valeurs peuvent évoluer dans le temps : ne rejetez pas les codes inconnus.
email.email_intelligence et email.enrichment sont des alias de compatibilité pointant vers le même objet normalisé. Les nouvelles intégrations peuvent lire email.enrichment.
email.matches liste les autres sessions de votre application où la même adresse a été utilisée par un autre utilisateur. Utilisez-le pour détecter les comptes en double.
request_id correspond à l’identifiant de la session d’API. Stockez-le avec vendor_data si vous devez corréler le résultat avec des webhooks ultérieurs ou avec l’activité de la console.

email.email_intelligence et email.enrichment sont des champs fournis dans la mesure du possible. Une recherche terminée peut omettre les deux lorsqu’aucune donnée exploitable issue de l’analyse n’est renvoyée pour cette adresse, ce domaine ou ce forfait. Construisez d’abord vos règles sur is_breached, is_disposable et is_undeliverable, et traitez une intelligence manquante comme « inconnue », et non comme « sûre ».

Module complémentaire d’empreinte sociale

Définissez enable_social sur true pour ajouter un bloc email_social à la réponse, sous email : les plateformes en ligne sur lesquelles cette adresse e-mail est enregistrée, regroupées par catégorie, avec les totaux récapitulatifs et les détails de profil renvoyés par nos partenaires de données, lorsqu’ils sont disponibles.

email.email_social.profiles_registered et email.email_social.profiles_checked sont les chiffres clés : les plateformes sur lesquelles l’adresse e-mail est confirmée comme enregistrée, sur l’ensemble des plateformes évaluées.
email.email_social.registered_platforms et email.email_social.not_registered_platforms listent chaque plateforme avec sa category et son scope (global, ou local pour les plateformes propres à une région).
email.email_social.categories indique le nombre d’enregistrements et le ratio par catégorie, et email.email_social.profiles contient les détails de profil par plateforme lorsqu’une plateforme les expose (nom, URL de la photo, texte de présentation, statut de confidentialité, indicateur de compte professionnel).
Les indices de synthèse (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) sont des composites de 0 à 10. Chaque nombre peut être null lorsque la vérification n’a renvoyé aucune donnée pour celui-ci.

profiles_registered: 0 est une réponse valide, et non un échec : les plateformes ont été vérifiées et l’adresse e-mail n’a été trouvée sur aucune d’elles, ce qui constitue un signal courant d’identité synthétique. L’endpoint n’agit pas seul sur ce signal : utilisez email_no_social_presence_action dans un workflow pour le transformer en verdict En cours d’examen ou Refusé. Le bloc est absent lorsque enable_social n’est pas défini, et également lorsque la vérification sociale n’a pas pu être terminée, auquel cas elle n’est pas facturée.

Comportement du sandbox

Les clés sandbox valident la requête et renvoient des données approuvées déterministes. Elles n’envoient aucun e-mail, ne consomment aucun crédit, ne créent aucune session et ne contribuent pas à Réseaux. Lorsque enable_social est défini, elles renvoient également un bloc email_social déterministe.

Facturation

Les appels à l’Email Risk API coûtent $0.04 au tarif catalogue, soit moins que la Vérification de l’e-mail complète, car aucun e-mail n’est envoyé. Une requête en production est facturable dès que la recherche démarre, même lorsque certains champs fournis dans la mesure du possible ne sont pas disponibles. Le module complémentaire d’empreinte sociale est facturé séparément : une unité email_social par requête, en plus du prix de l’Email Risk API, dès que la vérification est terminée. La vérification de crédit effectuée avant la recherche couvre les deux.

Autorisations

x-api-key

string

header

requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Corps

application/json

string<email>

requis

Adresse e-mail à évaluer.

Exemple:

"alice@example.com"

country_code

string

Indication de pays ISO 3166-1 alpha-2 ou alpha-3 optionnelle pour la couverture du renseignement.

Maximum string length: 3

Exemple:

"US"

signals

object

Contexte d'appareil et de réseau optionnel observé par votre application. Tous les champs sont optionnels. Les renseigner alimente la détection de correspondance inter-sessions dans Networks.

Show child attributes

vendor_data

string

Votre référence stable pour cette requête. Enregistrée sur la session API et renvoyée dans la réponse.

metadata

object | null

Vos métadonnées JSON non sensibles. Enregistrées sur la session d'API et renvoyées dans la réponse.

Si true, recherche également l'empreinte sociale de l'adresse : les plateformes d'e-mail, sociales, professionnelles, d'e-commerce et de divertissement sur lesquelles elle est enregistrée. Facturé comme une unité email_social par requête en plus du prix propre à cet endpoint.

Exemple:

true

Réponse

L'évaluation du risque est terminée. Inspectez status pour connaître la décision ; le code HTTP est toujours 200 pour les recherches terminées.

request_id

string<uuid>

requis

Identifiant de la session d'API créée pour cette requête. Enregistrez-le avec vendor_data si vous devez faire correspondre le résultat avec des webhooks ultérieurs ou l'activité de la console.

status

enum<string>

requis

Décision finale pour cette session d'API. Habituellement Approved ; l'évaluation des risques peut donner In Review ou Declined.

Options disponibles:

Approved,

In Review,

Declined

created_at

string<date-time>

requis

Horodatage de cette réponse.

vendor_data

string | null

Écho des vendor_data que vous avez envoyées, null si vous n'en avez pas envoyé.

metadata

object | null

Écho des metadata que vous avez envoyées, null si vous n'en avez pas envoyé.

object

Rapport d'e-mail normalisé, le même bloc que celui utilisé par les réponses de Vérification de l'e-mail.

Show child attributes

Dernière modification le 7 novembre 2026

​Interpréter la réponse

​Module complémentaire d’empreinte sociale

​Comportement du sandbox

​Facturation

Autorisations

Corps

Réponse

Interpréter la réponse

Module complémentaire d’empreinte sociale

Comportement du sandbox

Facturation