Documentación

API para desarrolladores

Verifica correos desde tu propio sistema. Una clave pública para el navegador y una secreta para tu servidor.

La documentación es pública; tus claves se crean en tu panel tras iniciar sesión.

Autenticación

Envía tu clave en la cabecera Authorization. La pública (vl_pub_) va en el navegador; la secreta (vl_sec_), solo en tu servidor.

Authorization: Bearer vl_sec_...

Endpoints

Estos son los principales. La referencia completa, con tus claves, está en tu panel, en Desarrolladores.

Método	Ruta	Qué hace
POST	/api/v1/open/v1/verify	Verifica un correo y lo guarda en tu grupo de trabajo
POST	/api/v1/open/v1/jobs	Crea un trabajo de verificación desde un archivo
GET	/api/v1/open/v1/jobs/{id}	Consulta el estado y los contadores de un trabajo
GET	/api/v1/open/v1/jobs/{id}/results	Lista los resultados de un trabajo
GET	/api/v1/open/v1/jobs/{id}/download	Descarga los resultados en CSV

Ejemplo

Sustituye TU_CLAVE por tu clave secreta. En el panel tienes ejemplos para HTML, JavaScript, cURL, Python, PHP, Ruby y Java.

cURL

curl -X POST 'https://validaremail.com/api/v1/open/v1/verify' \
  -H 'Authorization: Bearer TU_CLAVE_SECRETA' \
  -H 'Content-Type: application/json' \
  -d '{"email":"cliente@empresa.com"}'

Python

import requests

resp = requests.post(
    "https://validaremail.com/api/v1/open/v1/verify",
    headers={"Authorization": "Bearer TU_CLAVE_SECRETA"},
    json={"email": "cliente@empresa.com"},
    timeout=20,
)
print(resp.json()["status"])