Eventos de verificação
Endereços individuais verificados pela API e cada endereço de uma lista de verificação assim que a verificação dele termina.
email_verification.created
Enviado quando você verifica um endereço com Verificar um endereço. A verificação já está concluída, e o payload corresponde à resposta da API. Os endereços de listas de verificação enviam email_verification.updated em vez deste evento.
As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.
Campos
event_idstringID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.
typestringSempre email_verification.created.
objectobjectA verificação que o evento descreve. Os campos dela estão listados abaixo.
data.objectobjectO mesmo objeto de novo, no formato que a API de eventos retorna em data.
Objeto de verificação
idstringID da verificação (ev_…).
objectstringSempre email_verification.
emailstringEndereço verificado.
statusstringcompleted quando a verificação terminou, ou failed.
scoreintegerPontuação de 0 a 100.
riskstringlow, medium ou high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role ou unknown. Consulte Verificar um endereço.
modestringfast ou full. Os endereços de listas são sempre verificados no modo full.
checksobjectVerificações individuais. As verificações da caixa de e-mail smtp_connect, deliverable, disabled, inbox_full e catch_all são null no modo fast.
addressobjectO endereço dividido em mailbox, domain, suffix (a parte depois de +) e root.
did_you_meanstring | nullSugestão de correção para um provável erro de digitação.
mx_recordsobject[]Registros MX do domínio, cada um com priority e exchange.
created_atstringQuando a verificação foi criada, em ISO 8601 com deslocamento UTC.
updated_atstringQuando a verificação foi atualizada pela última vez.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.created",
"object": {
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
},
"data": {
"object": {
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"free_email": false,
"gibberish": false,
"catch_all": null,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
}
}
}email_verification.updated
Enviado quando o Emailit termina de verificar um endereço de uma lista de verificação, uma vez por endereço. Uma lista de 10.000 endereços envia 10.000 destes eventos; se você só precisa saber quando a lista inteira terminou, escute email_verification_list.updated em vez deste evento.
As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.
Campos
event_idstringID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.
typestringSempre email_verification.updated.
objectobjectA verificação que o evento descreve. Os campos dela estão listados abaixo.
data.objectobjectO mesmo objeto de novo, no formato que a API de eventos retorna em data.
Objeto de verificação
idstringID da verificação (ev_…).
objectstringSempre email_verification.
emailstringEndereço verificado.
statusstringcompleted quando a verificação terminou, ou failed.
scoreintegerPontuação de 0 a 100.
riskstringlow, medium ou high.
resultstringsafe, invalid, disposable, disabled, inbox_full, role ou unknown. Consulte Verificar um endereço.
modestringfast ou full. Os endereços de listas são sempre verificados no modo full.
checksobjectVerificações individuais. As verificações da caixa de e-mail smtp_connect, deliverable, disabled, inbox_full e catch_all são null no modo fast.
addressobjectO endereço dividido em mailbox, domain, suffix (a parte depois de +) e root.
did_you_meanstring | nullSugestão de correção para um provável erro de digitação.
mx_recordsobject[]Registros MX do domínio, cada um com priority e exchange.
created_atstringQuando a verificação foi criada, em ISO 8601 com deslocamento UTC.
updated_atstringQuando a verificação foi atualizada pela última vez.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "email_verification.updated",
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"free_email": false,
"gibberish": false,
"catch_all": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
},
"data": {
"object": {
"id": "ev_2xLeA1Pn6Rw3Ks8Vb0Ht5Mq2Fd9c",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"free_email": false,
"gibberish": false,
"catch_all": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 10957
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mx1.example.com"
}
],
"created_at": "2026-10-01T10:30:02.441000+00:00",
"updated_at": "2026-10-01T10:30:09.876000+00:00"
}
}
}