Saltar al contenido
Docs

Verifica una dirección en tiempo real.

URL basehttps://api.emailit.com/v2AutenticaciónErroresLímites de velocidad

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.

POST/email-verifications

Cuerpo de la petición

emailstringObligatorio

La 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.

modestring

fast (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

statusstring

completed en las verificaciones individuales.

checksobject

Las 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).

addressobject

La 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 | null

Una 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.

POST/email-verifications
Terminal
curl -X POST https://api.emailit.com/v2/email-verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "ada@example.com"}'
JSON
{
  "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"
}

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.