API para verificar OTP de e-mail: validar código

curl

curl -X POST https://verification.didit.me/v3/email/check/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "alice@example.com",
    "code": "123456",
    "disposable_email_action": "DECLINE"
  }'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.email.checkCode({
  email: "alice@example.com",
  code: "123456",
});
console.log(result);

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

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

import me.didit.Didit;
import me.didit.types.EmailCheckCodeParams;

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

var result = client.email().checkCode(EmailCheckCodeParams.builder()
        .email("alice@example.com")
        .code("123456")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->email->checkCode([
    'email' => 'alice@example.com',
    'code' => '123456',
]);
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.CheckCodeAsync(new EmailCheckCodeParams
{
    Email = "alice@example.com",
    Code = "123456",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "e39cb057-92fc-4b59-b84e-02fec29a0f24",
  "status": "Approved",
  "message": "The verification code is correct.",
  "email": {
    "status": "Approved",
    "email": "alice@example.com",
    "is_breached": false,
    "breaches": [],
    "is_disposable": false,
    "is_undeliverable": false,
    "verification_attempts": 1,
    "verified_at": "2026-06-12T01:24:47.311323Z",
    "warnings": [],
    "lifecycle": [
      {
        "type": "EMAIL_VERIFICATION_MESSAGE_SENT",
        "timestamp": "2026-06-12T01:23:39.580554+00:00",
        "details": {
          "status": "Success",
          "reason": null
        },
        "fee": 0.02
      },
      {
        "type": "VALID_CODE_ENTERED",
        "timestamp": "2026-06-12T01:24:47.311201+00:00",
        "details": {
          "code_tried": "123456",
          "status": "Approved"
        },
        "fee": 0
      },
      {
        "type": "EMAIL_VERIFICATION_APPROVED",
        "timestamp": "2026-06-12T01:24:47.384292+00:00",
        "details": null,
        "fee": 0
      }
    ],
    "matches": []
  },
  "vendor_data": "user-1234",
  "metadata": null,
  "created_at": "2026-06-12T01:24:47.401719+00:00"
}

POST

check

curl

curl -X POST https://verification.didit.me/v3/email/check/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "alice@example.com",
    "code": "123456",
    "disposable_email_action": "DECLINE"
  }'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.email.checkCode({
  email: "alice@example.com",
  code: "123456",
});
console.log(result);

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

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

import me.didit.Didit;
import me.didit.types.EmailCheckCodeParams;

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

var result = client.email().checkCode(EmailCheckCodeParams.builder()
        .email("alice@example.com")
        .code("123456")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->email->checkCode([
    'email' => 'alice@example.com',
    'code' => '123456',
]);
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.CheckCodeAsync(new EmailCheckCodeParams
{
    Email = "alice@example.com",
    Code = "123456",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "e39cb057-92fc-4b59-b84e-02fec29a0f24",
  "status": "Approved",
  "message": "The verification code is correct.",
  "email": {
    "status": "Approved",
    "email": "alice@example.com",
    "is_breached": false,
    "breaches": [],
    "is_disposable": false,
    "is_undeliverable": false,
    "verification_attempts": 1,
    "verified_at": "2026-06-12T01:24:47.311323Z",
    "warnings": [],
    "lifecycle": [
      {
        "type": "EMAIL_VERIFICATION_MESSAGE_SENT",
        "timestamp": "2026-06-12T01:23:39.580554+00:00",
        "details": {
          "status": "Success",
          "reason": null
        },
        "fee": 0.02
      },
      {
        "type": "VALID_CODE_ENTERED",
        "timestamp": "2026-06-12T01:24:47.311201+00:00",
        "details": {
          "code_tried": "123456",
          "status": "Approved"
        },
        "fee": 0
      },
      {
        "type": "EMAIL_VERIFICATION_APPROVED",
        "timestamp": "2026-06-12T01:24:47.384292+00:00",
        "details": null,
        "fee": 0
      }
    ],
    "matches": []
  },
  "vendor_data": "user-1234",
  "metadata": null,
  "created_at": "2026-06-12T01:24:47.401719+00:00"
}

Complemento de inteligência

Defina enable_enrichment como true para também executar a análise de inteligência de e-mail do endereço: uma pontuação de risco e o histórico de vazamentos de dados. O complemento é cobrado a $0.05 por requisição pelo preço de tabela, além do preço da verificação. A requisição retorna 403 quando o seu saldo não consegue cobrir o custo. Três campos definem o que acontece com os sinais. Cada um é NO_ACTION (o padrão) ou DECLINE, e cada um só tem efeito quando enable_enrichment é true.

Campo	Recusa quando
`email_intelligence_score_action`	A pontuação de risco está acima do limiar.
`recent_email_breach_action`	O endereço aparece em um vazamento de dados conhecido e recente.
`frequent_email_breach_action`	O endereço aparece em muitos vazamentos de dados conhecidos.

Com NO_ACTION, o sinal continua sendo retornado em email.email_intelligence, para que você possa aplicar a sua própria regra.

Autorizações

x-api-key

string

header

obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json

string<email>

obrigatório

O mesmo endereço de e-mail usado na chamada correspondente a POST /v3/email/send/. É isso que vincula a verificação ao envio.

Exemplo:

"alice@example.com"

code

string

obrigatório

O OTP que o usuário final recebeu: de 4 a 8 dígitos, ou de 4 a 8 letras/dígitos quando alphanumeric_code: true foi usado no envio. A comparação não diferencia maiúsculas de minúsculas.

Maximum string length: 10

Exemplo:

"123456"

duplicated_email_action

enum<string>

padrão:NO_ACTION

O que fazer quando o mesmo endereço já foi usado e aprovado por outro usuário (somente verificações aprovadas anteriormente são consideradas) (vendor_data diferente) da sua aplicação. DECLINE altera o status final para Declined; NO_ACTION registra o risco em email.warnings e preenche email.matches.

Opções disponíveis:

NO_ACTION,

DECLINE

breached_email_action

enum<string>

padrão:NO_ACTION

O que fazer quando o endereço aparece em vazamentos de dados conhecidos (email.is_breached). DECLINE muda o status final para Declined; NO_ACTION registra o risco em email.warnings.

Opções disponíveis:

NO_ACTION,

DECLINE

disposable_email_action

enum<string>

padrão:NO_ACTION

O que fazer quando o domínio pertence a um provedor de e-mail descartável/temporário (email.is_disposable). DECLINE altera o status final para Declined; NO_ACTION registra o risco em email.warnings.

Opções disponíveis:

NO_ACTION,

DECLINE

enable_enrichment

boolean

padrão:false

Quando true, também executa a inteligência de e-mail no endereço: uma pontuação de risco e o histórico de vazamentos. Cobrado como uma unidade email_intelligence_api por requisição ($0.05 pelo preço de tabela), além do preço próprio deste endpoint. A requisição retorna 403 quando o seu saldo não é suficiente para cobri-la.

Exemplo:

false

email_intelligence_score_action

enum<string>

padrão:NO_ACTION

Ação quando a pontuação de risco da inteligência de e-mail está acima do limiar. DECLINE muda o status final para Declined; NO_ACTION registra o sinal sem recusar. Só tem efeito quando enable_enrichment é true.

Opções disponíveis:

NO_ACTION,

DECLINE

recent_email_breach_action

enum<string>

padrão:NO_ACTION

Ação quando o endereço aparece em um vazamento de dados conhecido e recente. DECLINE muda o status final para Declined; NO_ACTION registra o sinal sem recusar. Só tem efeito quando enable_enrichment é true.

Opções disponíveis:

NO_ACTION,

DECLINE

frequent_email_breach_action

enum<string>

padrão:NO_ACTION

Ação quando o endereço aparece em muitos vazamentos de dados conhecidos. DECLINE muda o status final para Declined; NO_ACTION registra o sinal sem recusar. Só tem efeito quando enable_enrichment é true.

Opções disponíveis:

NO_ACTION,

DECLINE

Quando verdadeiro, também consulta a presença digital do endereço: as plataformas de e-mail, redes sociais, profissionais, e-commerce e entretenimento em que ele está cadastrado. Cobrado como uma unidade email_social por requisição, além do preço deste endpoint.

Exemplo:

true

Ação quando a verificação de pegada social não encontra o endereço registrado em nenhuma das plataformas que ela cobre. Somente NO_ACTION e DECLINE são aceitos neste endpoint; REVIEW está disponível na chave de configuração do fluxo de mesmo nome.

Opções disponíveis:

NO_ACTION,

DECLINE

Resposta

Verificação concluída — códigos incorretos e verificações inexistentes também retornam 200; confira status, não o código HTTP. email é preenchido apenas em resultados finalizados (Approved/Declined), é null em Failed e fica ausente em Expired or Not Found.

request_id

string<uuid>

Em Approved/Declined: o ID da sessão da verificação correspondente, idêntico ao request_id retornado por POST /v3/email/send/. Em Failed e Expired or Not Found: um UUID aleatório de uso único que não pode ser consultado depois.

status

enum<string>

Approved: código correto, sem risco que cause recusa. Declined: terminal; um risco que causa recusa foi identificado ou o limite de tentativas (3) foi esgotado. Failed: código errado, ainda restam tentativas. Expired or Not Found: não há verificação pendente para este endereço nos últimos 5 minutos.

Opções disponíveis:

Approved,

Declined,

Failed,

Expired or Not Found

message

string

Explicação legível do resultado, incluindo o número de tentativas restantes após um código incorreto.

object | null

Relatório completo de e-mail. Presente (não nulo) somente em resultados finalizados (Approved/Declined); null em Failed e ausente em Expired or Not Found.

Show child attributes

vendor_data

string | null

vendor_data da sessão da verificação correspondente. null em Expired or Not Found.

metadata

object | null

metadata da sessão da verificação correspondente. null em Expired or Not Found.

created_at

string<date-time>

Data e hora desta resposta de verificação.

Última modificação em 1 de novembro de 2026

​Complemento de inteligência

Autorizações

Corpo

Resposta

Complemento de inteligência