API de riesgo de email: entregabilidad y filtraciones

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

Usa POST /v3/email/risk/ cuando necesites inteligencia sobre correos electrónicos sin pedir al usuario que introduzca un código de un solo uso. No envía ningún correo electrónico. Crea una sesión de API, enriquece la dirección, aplica tus reglas de riesgo de correo electrónico y devuelve, en una única respuesta síncrona, el mismo bloque normalizado de correo electrónico que usa la Verificación de correo electrónico. Cuando se guarda la solicitud, Didit también puede usar la dirección de correo electrónico evaluada como evidencia agregada en Networks. Los grafos de red pueden mostrar inteligencia de correo electrónico de alto riesgo, contexto de filtraciones y cobertura de perfiles sociales en señales de correo electrónico compartidas, pero no revelan la dirección de correo electrónico sin procesar a otras organizaciones.

Cómo interpretar la respuesta

status es la decisión final de esta sesión de API. Normalmente es Approved; la evaluación de riesgo puede dar como resultado In Review o Declined.
email.is_breached, email.is_disposable y email.is_undeliverable son las señales estables de sí/no para la lógica de tu aplicación.
email.breaches enumera las filtraciones conocidas más recientes que contienen la dirección, cuando hay cobertura disponible, con la fecha de la filtración y las clases de datos expuestas.
email.email_intelligence.score usa una escala de riesgo de 0 a 100 en la que un número más alto indica un riesgo mayor. breach_risk_level (Low, Medium, High) y no_of_breaches son vistas derivadas.
email.email_intelligence.reason_codes explica qué señales normalizadas contribuyeron al resultado. La lista de valores puede crecer con el tiempo, así que no rechaces los códigos desconocidos.
email.email_intelligence y email.enrichment son alias de compatibilidad que contienen el mismo objeto normalizado. Las integraciones nuevas pueden leer email.enrichment.
email.matches enumera otras sesiones de tu aplicación en las que un usuario distinto usó la misma dirección. Úsalo para detectar cuentas duplicadas.
request_id es el ID de la sesión de API. Guárdalo junto con vendor_data si necesitas correlacionar el resultado con webhooks posteriores o con la actividad en la consola.

email.email_intelligence y email.enrichment se proporcionan según disponibilidad. Una consulta completada puede omitir ambos cuando no se devuelven datos de inteligencia utilizables para esa dirección, ese dominio o ese plan. Basa tus reglas primero en is_breached, is_disposable y is_undeliverable, y trata la ausencia de inteligencia como “desconocido”, no como “seguro”.

Establece enable_social en true para añadir un bloque email_social a la respuesta, dentro de email: las plataformas en línea en las que está registrada esta dirección de correo electrónico, agrupadas por categoría, con los recuentos resumidos y los detalles de perfil que devuelvan nuestros socios de datos.

email.email_social.profiles_registered y email.email_social.profiles_checked son las cifras principales: las plataformas en las que se ha confirmado que la dirección de correo electrónico está registrada, del total de plataformas evaluadas.
email.email_social.registered_platforms y email.email_social.not_registered_platforms enumeran cada plataforma con su category y su scope (global, o local para plataformas específicas de una región).
email.email_social.categories indica el recuento de registros y la proporción por categoría, y email.email_social.profiles incluye los detalles de perfil por plataforma cuando una plataforma los expone (nombre, URL de la foto, texto de presentación, estado de privacidad e indicador de cuenta de empresa).
Los índices resumidos (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) son indicadores compuestos de 0 a 10. Cualquier recuento puede ser null cuando la comprobación no devolvió datos para él.

profiles_registered: 0 es una respuesta real, no un fallo: se comprobaron las plataformas y la dirección de correo electrónico no se encontró en ninguna de ellas, lo que es una señal habitual de identidad sintética. Este endpoint no actúa sobre ella por sí solo: usa email_no_social_presence_action en un flujo para convertirla en un veredicto de revisión o de rechazo. El bloque no aparece cuando enable_social no está establecido, ni tampoco cuando no se pudo completar la comprobación social, en cuyo caso no se factura.

Comportamiento en sandbox

Las claves de sandbox validan la solicitud y devuelven datos aprobados deterministas. No envían ningún correo electrónico, no consumen créditos, no crean una sesión ni contribuyen a Networks. Con enable_social configurado, también devuelven un bloque email_social determinista.

Facturación

Las llamadas a la Email Risk API cuestan $0.04 a precio de lista, menos de lo que costaría una Verificación de correo electrónico completa, porque no se envía ningún correo electrónico. Una solicitud en producción se factura en cuanto comienza la consulta, aunque algunos campos de disponibilidad no garantizada no estén disponibles. El complemento de huella social se factura por separado: una unidad de email_social por solicitud, además del precio de la Email Risk API, siempre que la comprobación se complete. La comprobación de créditos previa a la consulta se aplica a ambos.

Autorizaciones

x-api-key

string

header

requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json

string<email>

requerido

Dirección de correo electrónico que se va a puntuar.

Ejemplo:

"alice@example.com"

country_code

string

Indicación de país ISO 3166-1 alfa-2 o alfa-3 opcional para la cobertura de inteligencia.

Maximum string length: 3

Ejemplo:

"US"

signals

object

Contexto opcional de dispositivo y red observado por tu aplicación. Todos los campos son opcionales. Enviarlos alimenta la detección de coincidencias entre sesiones en Networks.

Show child attributes

vendor_data

string

Tu referencia estable para esta solicitud. Se guarda en la sesión de API y se devuelve en la respuesta.

metadata

object | null

Tus metadatos JSON no sensibles. Se almacenan en la sesión de API y se devuelven en la respuesta.

Si es true, también se consulta la huella social de la dirección: las plataformas de correo electrónico, redes sociales, profesionales, comercio electrónico y entretenimiento en las que está registrada. Se factura como una unidad email_social por solicitud, además del precio propio de este endpoint.

Ejemplo:

true

Respuesta

La evaluación de riesgo se completó. Consulta status para ver la decisión; el código HTTP siempre es 200 en las consultas completadas.

request_id

string<uuid>

requerido

ID de la sesión de API creada para esta solicitud. Guárdalo junto con vendor_data si necesitas relacionar el resultado con webhooks posteriores o con la actividad en la consola.

status

enum<string>

requerido

Decisión final de esta sesión de API. Normalmente es Approved; la evaluación de riesgo puede producir In Review o Declined.

Opciones disponibles:

Approved,

In Review,

Declined

created_at

string<date-time>

requerido

Marca de tiempo de esta respuesta.

vendor_data

string | null

Devuelve el vendor_data que enviaste, o null si no enviaste ninguno.

metadata

object | null

Devuelve el metadata que enviaste, o null si no enviaste ninguno.

object

Informe de correo electrónico normalizado, el mismo bloque que usan las respuestas de Verificación de correo electrónico.

Show child attributes

Última modificación el 1 de noviembre de 2026

​Cómo interpretar la respuesta

​Complemento de huella social

​Comportamiento en sandbox

​Facturación

Autorizaciones

Cuerpo

Respuesta

Cómo interpretar la respuesta

Complemento de huella social

Comportamiento en sandbox

Facturación