Saltar al contenido principal
GET
/
v1
API de validación de email
curl --request GET \
  --url https://emailvalidation.cleariflow.com/v1
{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

​
Inicio rápido

Para hacer una solicitud, indique su api_key única y el email que desea verificar; no se requiere nada más: 
https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = jane.doe@acme-corp.com
La solicitud se completa correctamente y devuelve toda la información disponible sobre la dirección: 
{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

​
Parámetros de solicitud

​
api_key
string
requerido
Su credencial API personal. Las claves están limitadas por producto de Cleariflow, por lo que una clave de validación de email no autorizará solicitudes a, por ejemplo, la API de geolocalización IP.
​
email
String
requerido
La dirección de email que desea verificar.
​
auto_correct
Boolean
Indicador opcional para desactivar la autocorrección. Establezca auto_correct=false para desactivarla. Está habilitada de forma predeterminada.

​
Parámetros de respuesta

Las respuestas se devuelven en JSON compacto y estandarizado.
​
email
String
Devuelve el email enviado en la solicitud.
​
auto_correct
String
Corrección sugerida cuando se detecta un posible error tipográfico (p. ej., johnsmith@gmial.com => johnsmith@gmail.com). Vacío si no hay sugerencia.
​
deliverability
String
Evaluación de Cleariflow sobre si la dirección puede recibir correo. Valores posibles: DELIVERABLE, UNDELIVERABLE, UNKNOWN. En planes de pago, DELIVERABLE requiere una verificación SMTP exitosa; si existen registros MX pero SMTP no puede confirmar el buzón (común en grandes proveedores), el resultado es UNKNOWN. En planes gratuitos el valor es UNKNOWN salvo direcciones claramente no entregables (formato inválido o dominio desechable).
​
quality_score
Float
Puntuación decimal (0,01–0,99) que indica nuestra confianza en la calidad y entregabilidad de la dirección.
​
is_valid_format
Boolean
Verdadero cuando la dirección coincide con el patrón estándar local@domain.tld. Elementos faltantes o caracteres no válidos devuelven false.
​
is_free_email
Boolean
Verdadero si el dominio pertenece a un proveedor de email gratuito (p. ej., Gmail, Yahoo).
​
is_disposable_email
Boolean
Verdadero si el dominio está en nuestra lista de proveedores de buzones desechables/temporales (p. ej., Mailinator, Yopmail).
​
is_role_email
Boolean
Verdadero si la parte local parece ser una cuenta de rol en lugar de un individuo, p. ej., team@, sales@, info@.
​
is_catchall_email
Boolean
Verdadero si el dominio está configurado como catch‑all. Solo disponible en planes de pago; devuelve null/UNKNOWN en planes gratuitos.
​
is_mx_found
Boolean
Verdadero cuando existen registros MX para el dominio. Solo disponible en planes de pago; devuelve null/UNKNOWN en planes gratuitos.
​
is_smtp_valid
Boolean
Verdadero si la verificación SMTP tiene éxito. Si SMTP falla pero otras comprobaciones pasan, el resultado puede ser UNKNOWN. No recomendamos bloquear registros o envíos de formularios únicamente por fallos SMTP. Solo disponible en planes de pago; devuelve null/UNKNOWN en planes gratuitos.

​
Ejemplos de solicitud

​
Ejemplo: posible error tipográfico

Este ejemplo muestra una solicitud en la que se detecta un posible error tipográfico en la dirección enviada. Incluso cuando se encuentra un posible error tipográfico, todas las demás comprobaciones (p. ej., email gratuito, dominio desechable) se realizan sobre la dirección enviada originalmente, no sobre la corrección sugerida. 
https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith@gmial.con
Una respuesta exitosa tiene este aspecto: 
{
  "email": "johnsmith@gmial.con",
  "autocorrect": "johnsmith@gmail.com",
  "deliverability": "UNKNOWN",
  "quality_score": 0.4,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": null,
    "text": "UNKNOWN"
  },
  "is_mx_found": {
    "value": null,
    "text": "UNKNOWN"
  },
  "is_smtp_valid": {
    "value": null,
    "text": "UNKNOWN"
  }
}

​
Ejemplo: formato no válido

Este ejemplo demuestra una dirección que no supera el formato básico. Cuando is_valid_format es false, las comprobaciones posteriores (p. ej., is_free_email, is_role_email) se omiten y se informan como false. 
https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith
Una respuesta exitosa tiene este aspecto: 
{
  "email": "johnsmith",
  "autocorrect": "",
  "deliverability": "UNDELIVERABLE",
  "quality_score": 0.0,
  "is_valid_format": {
    "value": false,
    "text": "FALSE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": false,
    "text": "FALSE"
  },
  "is_smtp_valid": {
    "value": false,
    "text": "FALSE"
  }
}

​
Carga masiva (CSV)

¿Prefiere no llamar a la API directamente? Use el cargador masivo CSV: los resultados se le enviarán por email cuando finalice el procesamiento. Al cargar un CSV, siga estas directrices:
  • Coloque las direcciones de email en la primera columna.
  • Elimine las filas en blanco.
  • Use una dirección por fila.
  • Limite los archivos a un máximo de 50.000 filas.

​
Códigos de respuesta y error

Los errores se devuelven en JSON con un código y una descripción legible. Los códigos más comunes se enumeran a continuación.
CodeTypeDetails
200OKSolicitud completada correctamente.
400Bad requestSolicitud mal formada o no válida.
401UnauthorizedAutenticación fallida, generalmente por una clave API faltante o no válida.
422Quota reachedCuota agotada (p. ej., créditos insuficientes en planes gratuitos).
429Too many requestsLímite de velocidad superado (los planes gratuitos permiten hasta 1 solicitud/segundo).
500Internal server errorError inesperado en nuestro lado.
503Service unavailableServicio temporalmente no disponible.

​
Otras notas

Nota de facturación: cada email evaluado consume un crédito por solicitud, independientemente del resultado. Enviar una dirección no válida (p. ej., “fda3346ds”) sigue contando como un crédito.