API Rischio Email: Consegnabilità e segnali di violazione

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/ quando ti serve l’intelligence sull’email senza chiedere all’utente di inserire un codice monouso. Non invia un’email. Crea una sessione API, arricchisce l’indirizzo, applica le regole di rischio email e restituisce, in un’unica risposta sincrona, lo stesso blocco email normalizzato usato dalla Verifica email. Quando la richiesta viene salvata, Didit può anche usare l’email valutata come evidenza aggregata in Reti. I grafi di rete possono mostrare intelligence sull’email ad alto rischio, contesto sulle violazioni e copertura dei profili social su segnali email condivisi, ma non rivelano l’indirizzo email grezzo ad altre organizzazioni.

Interpreta la risposta

status è la decisione finale per questa sessione API. Di norma è Approved; la valutazione del rischio può produrre In Review o Declined.
email.is_breached, email.is_disposable e email.is_undeliverable sono segnali stabili di tipo sì/no da usare nella logica applicativa.
email.breaches elenca le violazioni più recenti note che contengono l’indirizzo, quando la copertura è disponibile, con la data della violazione e le classi di dati esposte.
email.email_intelligence.score usa una scala di rischio da 0 a 100, dove un numero più alto indica un rischio più elevato. breach_risk_level (Low, Medium, High) e no_of_breaches sono viste derivate.
email.email_intelligence.reason_codes spiega quali segnali normalizzati hanno contribuito al risultato. L’insieme dei valori può ampliarsi nel tempo, quindi non rifiutare i codici sconosciuti.
email.email_intelligence e email.enrichment sono alias di compatibilità con lo stesso oggetto normalizzato. Le nuove integrazioni possono leggere email.enrichment.
email.matches elenca altre sessioni della tua applicazione in cui lo stesso indirizzo è stato usato da un utente diverso. Usalo per rilevare account duplicati.
request_id è l’id della sessione API. Salvalo insieme a vendor_data se ti serve correlare il risultato con webhook successivi o con l’attività in console.

email.email_intelligence e email.enrichment sono campi soggetti a disponibilità. Una ricerca completata può ometterli entrambi quando per quell’indirizzo, dominio o piano non viene restituito alcun dato di intelligence utilizzabile. Costruisci prima le regole su is_breached, is_disposable e is_undeliverable, e tratta i dati di intelligence mancanti come “sconosciuto”, non come “sicuro”.

Imposta enable_social su true per aggiungere un blocco email_social alla risposta, sotto email: le piattaforme online su cui questo indirizzo email è registrato, raggruppate per categoria, con i conteggi di sintesi e gli eventuali dettagli del profilo restituiti dai nostri partner di dati.

email.email_social.profiles_registered e email.email_social.profiles_checked sono i numeri principali: le piattaforme in cui l’indirizzo email risulta registrato, rispetto alle piattaforme valutate.
email.email_social.registered_platforms e email.email_social.not_registered_platforms elencano ogni piattaforma con la sua category e il suo scope (global, oppure local per le piattaforme specifiche di una regione).
email.email_social.categories fornisce il numero di registrazioni e il rapporto per categoria, mentre email.email_social.profiles riporta i dettagli del profilo per ogni piattaforma, quando la piattaforma li espone (nome, URL della foto, testo descrittivo, stato della privacy, indicazione di account aziendale).
Gli indici di sintesi (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) sono indicatori compositi su una scala da 0 a 10. Ogni conteggio può essere null quando il controllo non ha restituito dati per quel conteggio.

profiles_registered: 0 è una risposta reale, non un errore: le piattaforme sono state controllate e l’indirizzo email non è stato trovato su nessuna di esse, un segnale comune di identità sintetica. Questo endpoint non agisce autonomamente su questo dato: usa email_no_social_presence_action in un workflow per trasformarlo in un verdetto di revisione o di rifiuto. Il blocco è assente quando enable_social non è impostato, e anche quando il controllo social non è stato completato, nel qual caso non viene addebitato.

Comportamento della sandbox

Le chiavi sandbox convalidano la richiesta e restituiscono dati di approvazione deterministici. Non inviano un’email, non consumano crediti, non creano una sessione e non contribuiscono a Reti. Con enable_social impostato, restituiscono anche un blocco email_social deterministico.

Fatturazione

Le chiamate all’Email Risk API costano $0.04 al prezzo di listino, meno di quanto costerebbe una Verifica email completa perché non viene inviata alcuna email. Una richiesta in produzione è fatturabile non appena la ricerca inizia, anche quando alcuni campi soggetti a disponibilità non sono disponibili. Il componente aggiuntivo per l’impronta social viene fatturato separatamente: un’unità email_social per richiesta, oltre al prezzo dell’Email Risk API, ogni volta che il controllo viene completato. Il controllo dei crediti eseguito prima della ricerca copre entrambi.

Autorizzazioni

x-api-key

string

header

obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json

string<email>

obbligatorio

Indirizzo email da valutare.

Esempio:

"alice@example.com"

country_code

string

Suggerimento facoltativo sul paese ISO 3166-1 alpha-2 o alpha-3 per la copertura dell'intelligence.

Maximum string length: 3

Esempio:

"US"

signals

object

Contesto facoltativo di dispositivo e rete rilevato dalla tua applicazione. Tutti i campi sono facoltativi. Fornirli alimenta il rilevamento delle corrispondenze tra sessioni in Reti.

Show child attributes

vendor_data

string

Il tuo riferimento stabile per questa richiesta. Memorizzato nella sessione API e restituito nella risposta.

metadata

object | null

I tuoi metadati JSON non sensibili. Memorizzati nella sessione API e restituiti nella risposta.

Se true, cerca anche l'impronta social dell'indirizzo: le piattaforme email, social, professionali, di e-commerce e di intrattenimento su cui è registrato. Fatturato come un'unità email_social per richiesta in aggiunta al prezzo di questo endpoint.

Esempio:

true

Risposta

La valutazione del rischio è completata. Ispeziona status per la decisione; il codice HTTP è sempre 200 per le ricerche completate.

request_id

string<uuid>

obbligatorio

ID della sessione API creata per questa richiesta. Memorizzalo con vendor_data se hai bisogno di correlare il risultato con i webhook successivi o con l'attività nella console.

status

enum<string>

obbligatorio

Decisione finale per questa sessione API. Di norma Approved; la valutazione del rischio può produrre In Review o Declined.

Opzioni disponibili:

Approved,

In Review,

Declined

created_at

string<date-time>

obbligatorio

Timestamp di questa risposta.

vendor_data

string | null

Eco del vendor_data inviato, null se non ne hai inviato alcuno.

metadata

object | null

Eco del metadata inviato, null se non ne hai inviato alcuno.

object

Report normalizzato di verifica email, lo stesso blocco utilizzato dalle risposte di Verifica email.

Show child attributes

Ultima modifica il 7 novembre 2026

​Interpreta la risposta

​Componente aggiuntivo per l’impronta social

​Comportamento della sandbox

​Fatturazione

Autorizzazioni

Corpo

Risposta

Interpreta la risposta

Componente aggiuntivo per l’impronta social

Comportamento della sandbox

Fatturazione