Verificación de emails
Verifica una dirección en tiempo real.
Verificar una dirección
Verifica una dirección de email y devuelve el resultado en la respuesta. Cada verificación cuesta 5 créditos, que se cobran antes de la comprobación. Para verificar muchas direcciones a la vez, crea una lista de direcciones. Requiere una clave de API con el permiso full.
/email-verificationsCuerpo de la petición
emailstringObligatorioLa dirección que se va a verificar. Un valor que no es una dirección válida devuelve igualmente 200, con result: "invalid" y una puntuación de 0, y se cobra.
modestringfast (por defecto) comprueba la sintaxis, las direcciones desechables y de rol, los proveedores gratuitos, las cadenas sin sentido, los registros MX y la antigüedad del dominio. full además se conecta al servidor de correo del destinatario para comprobar si el buzón existe, está desactivado o está lleno, y si el dominio acepta todas las direcciones. Solo el modo full puede confirmar un buzón. En modo fast, las comprobaciones del buzón son null. full puede tardar hasta unos 40 segundos cuando un servidor de correo es lento, así que configura el tiempo de espera de tu cliente por encima de ese valor.
Devuelve
Devuelve 200 OK con un objeto email_verification. Emailit también envía un evento de webhook email_verification.created.
| Código | Cuándo |
|---|---|
400 |
Falta email o mode no es fast ni full (error de validación estándar). |
402 |
Al espacio de trabajo no le quedan 5 créditos. El cuerpo es {"error": {"message": "…", "code": 402}}. |
Resultado
result |
Significado |
|---|---|
safe |
full: el servidor de correo aceptó el buzón y rechazó una dirección inventada del mismo dominio. fast: ninguna comprobación ha fallado y la puntuación es 70 o más; no se ha comprobado el buzón. |
role |
Una dirección de rol, como info@ o support@. En modo full, también se ha confirmado el buzón. |
catch_all |
El dominio acepta correo para cualquier dirección, así que no se puede confirmar el buzón. Solo en modo full. |
unknown |
Sin respuesta clara: el servidor de correo bloqueó o aplazó la comprobación, no respondió, o falló la consulta DNS. En modo fast, también cuando ninguna comprobación ha fallado pero la puntuación es inferior a 70. |
inbox_full |
El buzón está lleno. Solo en modo full. |
disabled |
El buzón existe, pero está desactivado. Solo en modo full. |
disposable |
El dominio pertenece a un servicio de emails desechables. |
invalid |
La sintaxis no es válida, el dominio no tiene registros MX o el servidor de correo indicó que el buzón no existe. |
El orden en que Emailit los aplica se indica en Resultados de la verificación.
Puntuación y riesgo
score va de 0 a 100; las direcciones que no pueden recibir correo tienen 0. risk es high para invalid, disabled y disposable, y medium para catch_all, inbox_full y unknown (high si su puntuación es inferior a 50). Para safe y role, depende de la puntuación: low a partir de 80, medium a partir de 50 y high por debajo de 50. Consulta Puntuación.
Campos
statusstringcompleted en las verificaciones individuales.
checksobjectLas comprobaciones individuales: valid_syntax, disposable, role_account, free_email y gibberish (booleanos), has_mx_records (booleano, o null si falló la consulta DNS), domain_age (la antigüedad del dominio en días, o null si se desconoce) y las comprobaciones del modo full: smtp_connect, deliverable, disabled, inbox_full y catch_all (null en modo fast, y en modo full cuando el servidor de correo no dio una respuesta clara).
addressobjectLa dirección dividida en mailbox, domain, suffix (la parte que sigue a +, o null) y root (la dirección sin el sufijo).
did_you_meanstring | nullUna corrección sugerida para una probable errata, por ejemplo ada@gmail.com para ada@gmial.com.
mx_recordsobject[]Los registros MX del dominio, cada uno con priority y exchange.
{
"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,
"catch_all": null,
"free_email": false,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957,
"gibberish": false
},
"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"
}{
"error": {
"message": "Workspace has insufficient email credits for email verification. Each verification requires 5 credits.",
"code": 402
}
}