E-Mail-Risiko-API: Zustellbarkeit & Datenleck-Signale

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"
}

Verwenden Sie POST /v3/email/risk/, wenn Sie E-Mail-Informationen benötigen, ohne dass der Benutzer einen Einmalcode eingeben muss. Es wird keine E-Mail versendet. Der Endpoint erstellt eine API-Sitzung, reichert die Adresse an, wendet Ihre E-Mail-Risikoregeln an und gibt in einer synchronen Antwort denselben normalisierten E-Mail-Block zurück, der bei der E-Mail-Verifizierung verwendet wird. Wenn die Anfrage gespeichert wird, kann Didit die bewertete E-Mail-Adresse außerdem als aggregierten Nachweis in Netzwerke verwenden. Netzwerkgraphen können risikoreiche E-Mail-Informationen, Kontext zu Datenlecks und die Abdeckung von Social-Profilen bei gemeinsamen E-Mail-Signalen anzeigen. Sie geben jedoch nicht die Roh-E-Mail-Adresse an andere Organisationen weiter.

Antwort interpretieren

status ist die endgültige Entscheidung für diese API-Sitzung. Normalerweise ist er Approved. Die Risikobewertung kann In Review oder Declined ergeben.
email.is_breached, email.is_disposable und email.is_undeliverable sind die stabilen Ja/Nein-Signale für die Anwendungslogik.
email.breaches listet die neuesten bekannten Datenlecks auf, in denen die Adresse vorkommt, sofern Daten verfügbar sind. Angegeben werden jeweils das Datum des Lecks und die offengelegten Datenklassen.
email.email_intelligence.score verwendet eine Risikoskala von 0 bis 100, wobei ein höherer Wert ein höheres Risiko bedeutet. breach_risk_level (Low, Medium, High) und no_of_breaches sind abgeleitete Ansichten.
email.email_intelligence.reason_codes erklärt, welche normalisierten Signale zum Ergebnis beigetragen haben. Die Liste der Werte kann im Laufe der Zeit erweitert werden. Lehnen Sie daher unbekannte Codes nicht ab.
email.email_intelligence und email.enrichment sind Kompatibilitätsaliase mit demselben normalisierten Objekt. Neue Integrationen können email.enrichment lesen.
email.matches listet andere Sitzungen Ihrer Anwendung auf, in denen dieselbe Adresse von einem anderen Benutzer verwendet wurde. Verwenden Sie diese Liste zur Erkennung doppelter Konten.
request_id ist die API-Sitzungs-ID. Speichern Sie sie zusammen mit vendor_data, wenn Sie das Ergebnis später mit Webhooks oder Aktivitäten in der Konsole abgleichen möchten.

email.email_intelligence und email.enrichment sind Best-Effort-Felder. Eine abgeschlossene Abfrage kann beide Felder auslassen, wenn für diese Adresse, Domain oder diesen Tarif keine verwertbaren Informationen zurückgegeben werden. Erstellen Sie Regeln zuerst auf Basis von is_breached, is_disposable und is_undeliverable. Behandeln Sie fehlende Informationen als „unbekannt“, nicht als „sicher“.

Setzen Sie enable_social auf true, um dem Objekt email in der Antwort einen Block email_social hinzuzufügen. Dieser enthält die Online-Plattformen, auf denen diese E-Mail-Adresse registriert ist, nach Kategorien gruppiert, mit den zusammenfassenden Anzahlen und allen Profildetails, die unsere Datenpartner zurückgeben.

email.email_social.profiles_registered und email.email_social.profiles_checked sind die wichtigsten Kennzahlen: Plattformen, auf denen die E-Mail-Adresse nachweislich registriert ist, im Verhältnis zu den geprüften Plattformen.
email.email_social.registered_platforms und email.email_social.not_registered_platforms listen jede Plattform mit ihrer category und ihrem scope auf (global oder local für regionsspezifische Plattformen).
email.email_social.categories gibt die Anzahl der Registrierungen und das Verhältnis pro Kategorie an. email.email_social.profiles enthält die Profildetails pro Plattform, sofern eine Plattform sie bereitstellt (Name, Foto-URL, Info-Text, Datenschutzstatus, Kennzeichen für Geschäftskonten).
Die zusammenfassenden Indizes (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) sind zusammengesetzte Werte von 0 bis 10. Jeder Zählwert kann null sein, wenn die Prüfung dafür keine Daten geliefert hat.

profiles_registered: 0 ist eine gültige Antwort und kein Fehler. Die Plattformen wurden geprüft, und die E-Mail-Adresse wurde auf keiner davon gefunden. Das ist ein häufiges Signal für eine synthetische Identität. Dieser Endpoint reagiert darauf nicht von allein. Verwenden Sie email_no_social_presence_action in einem Workflow, um daraus eine Prüfungs- oder Ablehnungsentscheidung abzuleiten. Der Block fehlt, wenn enable_social nicht gesetzt ist. Er fehlt auch, wenn die Social-Prüfung nicht abgeschlossen werden konnte. In diesem Fall wird sie nicht abgerechnet.

Verhalten in der Sandbox

Sandbox-API-Schlüssel validieren die Anfrage und geben deterministische, genehmigte Daten zurück. Sie versenden keine E-Mail, verbrauchen keine Credits, erstellen keine Sitzung und tragen nicht zu Netzwerken bei. Wenn enable_social gesetzt ist, geben sie zusätzlich einen deterministischen Block email_social zurück.

Abrechnung

Aufrufe der Email Risk API kosten zum Listenpreis $0.04. Das ist weniger als bei einer vollständigen E-Mail-Verifizierung, weil keine E-Mail versendet wird. Eine Live-Anfrage ist abrechenbar, sobald die Abfrage beginnt, auch wenn einige Best-Effort-Felder nicht verfügbar sind. Die Social-Footprint-Zusatzfunktion wird separat abgerechnet: eine Einheit email_social pro Anfrage zusätzlich zum Preis der Email Risk API, sobald die Prüfung abgeschlossen ist. Die Credit-Prüfung vor der Abfrage deckt beides ab.

Autorisierungen

x-api-key

string

header

erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Body

application/json

string<email>

erforderlich

Zu bewertende E-Mail-Adresse.

Beispiel:

"alice@example.com"

country_code

string

Optionaler ISO 3166-1 alpha-2- oder alpha-3-Länderhinweis für die Informationsabdeckung.

Maximum string length: 3

Beispiel:

"US"

signals

object

Optionaler Geräte- und Netzwerkkontext, der von Ihrer Anwendung beobachtet wird. Alle Felder sind optional. Ihre Übergabe speist die sitzungsübergreifende Übereinstimmungserkennung in Networks.

Show child attributes

vendor_data

string

Ihre stabile Referenz für diese Anfrage. Wird in der API-Sitzung gespeichert und in der Antwort zurückgegeben.

metadata

object | null

Ihre nicht sensiblen JSON-Metadaten. Werden in der API-Sitzung gespeichert und in der Antwort zurückgegeben.

Wenn true, wird auch der digitale Fußabdruck der Adresse ermittelt – die E-Mail-, Social-, Berufs-, E-Commerce- und Unterhaltungsplattformen, auf denen sie registriert ist. Wird als eine email_social-Einheit pro Anfrage zusätzlich zum regulären Preis dieses Endpoints abgerechnet.

Beispiel:

true

Antwort

Die Risikobewertung wurde abgeschlossen. Prüfen Sie status für die Entscheidung; HTTP ist bei abgeschlossenen Abfragen immer 200.

request_id

string<uuid>

erforderlich

ID der API-Sitzung, die für diese Anfrage erstellt wurde. Speichern Sie sie zusammen mit vendor_data, wenn Sie das Ergebnis mit späteren Webhooks oder Konsolenaktivitäten korrelieren müssen.

status

enum<string>

erforderlich

Endgültige Entscheidung für diese API-Sitzung. Normalerweise Approved; die Risikobewertung kann In Review oder Declined ergeben.

Verfügbare Optionen:

Approved,

In Review,

Declined

created_at

string<date-time>

erforderlich

Zeitstempel dieser Antwort.

vendor_data

string | null

Rückgabe der von Ihnen gesendeten vendor_data, null, wenn Sie keine gesendet haben.

metadata

object | null

Rückgabe der von Ihnen gesendeten metadata, null, wenn Sie keine gesendet haben.

object

Normalisierter E-Mail-Bericht, derselbe Block wie in den Antworten der E-Mail-Verifizierung.

Show child attributes

Zuletzt geändert am 7. November 2026

​Antwort interpretieren

​Social-Footprint-Zusatzfunktion

​Verhalten in der Sandbox

​Abrechnung

Autorisierungen

Body

Antwort

Antwort interpretieren

Social-Footprint-Zusatzfunktion

Verhalten in der Sandbox

Abrechnung