> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API di verifica email: OTP e valutazione del rischio > Verifica email con Didit tramite OTP e valutazione del rischio. Rileva indirizzi compromessi e temporanei. $0.02 a chiamata, senza minimi mensili. La Verifica email di Didit offre un metodo affidabile per verificare gli indirizzi email degli utenti tramite codici monouso (OTP) e una valutazione avanzata del rischio. Questa funzionalità consente di garantire informazioni di contatto valide e raggiungibili, proteggendo al contempo da indirizzi email compromessi e ad alto rischio. Prompt di integrazione per la verifica email Copia il prompt negli appunti \

\````# Goal
Integrate Didit Email Verification (OTP send + check + deliverability / breach / disposable lookup) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when the user completes verification through a hosted Didit flow.

1\. Add the EMAIL feature to the workflow (Business Console or POST /v3/workflows/). Configure risk actions: duplicated_email_action, breached_email_action, disposable_email_action.
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `email_verifications[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server, OTP pair)
Two endpoints paired by email address.

Step 1 — send the code:
\```bash
curl -X POST 'https://verification.didit.me/v3/email/send/' \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "alice@example.com",
"options": { "code_size": 6, "locale": "en", "use_white_label_customization": false },
"vendor_data": "user-1234"
}'
\```
Default: 6 numeric digits and Didit-branded delivery. Set `options.alphanumeric_code: true` for letters+digits (check is case-insensitive). Set `options.use_white_label_customization: true` to use your application's configured white-label sender and branding for this standalone OTP email; the default is `false`. `options.code_size` 4–8. Codes expire in **5 minutes**; one free retry per email within the window.

Step 2 — check the code (user types it into your UI):
\```bash
curl -X POST 'https://verification.didit.me/v3/email/check/' \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "alice@example.com",
"code": "123456",
"disposable_email_action": "DECLINE"
}'
\```
Each session accepts **up to 3** code-entry attempts. The check response always includes the full email metadata (breaches[], disposable flag, deliverable flag).

\# Status enum (per email_verifications[].status / email.status)
"Not Started" | "In Progress" | "Approved" | "Declined" | "Failed" | "Undeliverable" | "Expired or Not Found" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.EMAIL)
warnings[] risk codes include:
DUPLICATED_EMAIL, BREACHED_EMAIL, DISPOSABLE_EMAIL, UNDELIVERABLE_EMAIL, INVALID_EMAIL, OTP_MAX_ATTEMPTS_REACHED, OTP_EXPIRED.
Full catalogue: /core-technology/email-verification/warnings-email-verification.

\# Failure modes to handle
\- send response status="Undeliverable" — bounce/invalid domain; no charge, surface to the user.
\- check response status="Failed" — wrong code, attempts remaining; re-prompt.
\- check response status="Declined" — third failed attempt; restart with /v3/email/send/.
\- check response status="Expired or Not Found" — outside the 5-minute window; restart.
\- BREACHED_EMAIL warning — the address appears in known breaches; route to review per policy.

\# See also
\- Canonical schema: /reference/data-models#email-verification
\- Per-feature report: /core-technology/email-verification/report-email-verification
\- Risk catalogue: /core-technology/email-verification/warnings-email-verification
\- Full integration playbook: /integration/integration-prompt````

\
Incolla in La lezione della Academy sulla lettura del risultato di una verifica affronta il controllo di verifica email al minuto 8:34.[Verifica email — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=514\&rel=0\&playsinline=1)![Diagramma del flusso di verifica email](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/email-verification-flow.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=23d035a261faa2063d6d941290ecf752)## Come funzionaLa nostra soluzione di Verifica email combina la verifica tramite OTP con indicatori di intelligence quali l'esposizione a data breach, la recapitabilità e la reputazione del provider.**1. Raccolta dell'email**Il sistema raccoglie in modo sicuro:| Input | Descrizione | | - | - | | **Indirizzo email** | Se non fornito durante la creazione della sessione, l'utente inserisce il proprio indirizzo email. Se fornito durante la creazione della sessione, l'utente deve verificare l'email precompilata. | | **Lingua preferita** | Utilizzata per comunicazioni localizzate, se applicabile. |**2. Generazione e consegna dell'OTP**Il nostro sistema di verifica:- Genera un codice monouso sicuro e a tempo limitato - Consegna il codice via email all'indirizzo fornito - Applica le migliori pratiche di recapitabilità per massimizzare il recapito nella posta in arrivo - Offre flussi di reinvio con protezioni per prevenire gli abusi**3. Convalida del codice**L'utente completa la verifica:- Inserendo il codice ricevuto nell'interfaccia di verifica - Inviandolo entro il limite di tempo configurato (5 minuti) - Richiedendo un nuovo codice se necessario (con appositi limiti di frequenza)**4. Valutazione del rischio**Il nostro sistema esegue controlli avanzati:| Controllo | Descrizione | | - | - | | **Esposizione a data breach** | Cerca l'email tra le violazioni di dati note ed elenca i servizi esposti. | | **Rilevamento di provider usa e getta** | Segnala le email provenienti da provider temporanei o usa e getta. | | **Controlli di recapitabilità** | Rileva indirizzi non recapitabili o sintatticamente non validi. | | **Segnali di reputazione** | Identifica pattern di email potenzialmente ad alto rischio. | | **Uso duplicato** | Effettua un confronto incrociato con i dati storici delle verifiche. |**5. Consegna dei risultati**Accedi ai risultati della verifica attraverso diversi canali:| Canale | Descrizione | | - | - | | **Dashboard** | Aggiornamenti in tempo reale sulla dashboard. | | **Webhook** | Notifiche webhook. | | **API** | Risposte API RESTful. | | **Report** | Report completi con informazioni dettagliate sulla verifica. |## Funzionalità di verificaIl nostro servizio di Verifica email offre diverse funzionalità chiave per ottimizzare il processo di verifica:#### Verifica OTP- **Generazione sicura del codice**: codici monouso casuali con scadenza temporale - **Consegna via email**: consegna via email affidabile e localizzata - **Timeout configurabili**: imposta i tempi di scadenza in base ai tuoi requisiti di sicurezza - **Opzioni di nuovo tentativo**: consenti agli utenti di richiedere nuovi codici entro limiti adeguati#### Analisi delle email- **Validazione della sintassi**: garantisce che l'indirizzo email segua il formato conforme agli standard RFC - **Controlli del provider**: identifica i provider temporanei o usa e getta - **Informazioni sulla recapitabilità**: rileva gli indirizzi non recapitabili - **Intelligence sulle violazioni**: mostra i record relativi a violazioni note con informazioni dettagliate#### Valutazione del rischio- **Rilevamento dell'esposizione**: identifica se l'email compare in violazioni note - **Rilevamento di email usa e getta**: segnala le email temporanee o usa e getta - **Monitoraggio delle attività**: traccia pattern sospetti tra i vari tentativi - **Controllo su blocklist**: effettua verifiche su elenchi interni di indirizzi email usati impropriamente in precedenza This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.