Documentos de la API de validación de correo electrónico

Primeros pasos

Todas las solicitudes de API requieren autenticación mediante una clave de API. Puede encontrar su clave API en el panel de control.

Cabecera: "x-api-key: tu-api-key"

Verificación única

Verifique la validez, el estado desechable, los servicios de privacidad y la capacidad de entrega de una única dirección de correo electrónico o dominio.

Punto final

GET /v1/verify

Parámetros

Nombre	Tipo	Requerido	Descripción
input	string	Sí	Dirección de correo electrónico o dominio a verificar (por ejemplo, [email protected] o example.com)

Campos de respuesta

Campo	Descripción
valid	Indica si el formato del correo electrónico es correcto
block	Indica si el correo electrónico debe bloquearse (true si disposable, privacy, applePrivateEmail, deliverable o catch_all es true)
disposable	Determina si la dirección de correo electrónico es temporal o desechable
privacy	Determina si el servidor de correo está utilizando un alias o reenviador de correo electrónico.
applePrivateEmail	Indica si el correo electrónico es una dirección privada de Apple
deliverable	Comprueba si el buzón existe y puede recibir correos electrónicos
domain	La parte del dominio de la dirección de correo electrónico
email_address	La dirección de correo electrónico
catch_all	Indica si el dominio tiene una configuración de correo electrónico catch-all que acepta todos los correos entrantes independientemente de la dirección del destinatario.
mx_found	Indica si el dominio tiene servidores de correo válidos (registros MX)
remaining_credits	El número de créditos API restantes en su cuenta

Lista negra / Lista blanca: Sólo el campo de bloqueo refleja la pertenencia a la lista. Lista negra → bloquear: true; lista blanca → bloquear: false; no en lista blanca (cuando está activado) → bloquear: true. No usar valid para decidir si se bloquea en función de las listas.

Ejemplo de respuesta

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Ejemplos de códigos

curl "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

Pruébalo

Clave API

Necesita una clave API para probar los puntos finales.

Dirección de correo o dominio

Prueba con:

Verificación de lotes

Verifique varias direcciones de correo electrónico o dominios en una sola solicitud (máx. 100 elementos).

Punto final

POST /v1/verify/batch

Parámetros

Nombre	Tipo	Requerido	Descripción
inputs	array of strings	Sí	Conjunto de direcciones de correo electrónico o dominios para verificar

Ejemplos de códigos

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "[email protected]",
      "[email protected]"
    ]
  }'

Pruébalo

Clave API

Necesita una clave API para probar los puntos finales.

Direcciones de correo o dominios

Pruebe con diferentes dominios:

Control de entregas

Comprobación rápida de la entregabilidad del correo electrónico mediante verificación MX y SMTP sin llamadas a API externas. Devuelve solo los campos relacionados con la entregabilidad para tiempos de respuesta más rápidos.

Punto final

GET /v1/verify/deliverable

Parámetros

Nombre	Tipo	Requerido	Descripción
input	string	Sí	Dirección de correo electrónico para comprobar la entregabilidad (por ejemplo, [email protected]). No se admite la entrada de solo dominio para este punto final.

Campos de respuesta

Campo	Descripción
valid	Indica si el formato del correo electrónico es correcto
deliverable	Comprueba si el buzón existe y puede recibir correos electrónicos
mx_found	Indica si el dominio tiene servidores de correo válidos (registros MX)
catch_all	Indica si el dominio tiene una configuración de correo electrónico catch-all que acepta todos los correos entrantes independientemente de la dirección del destinatario.
email_address	La dirección de correo electrónico
remaining_credits	El número de créditos API restantes en su cuenta

Ejemplo de respuesta

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "[email protected]",
  "remaining_credits": 99
}

Ejemplos de códigos

curl "https://api.verify-email.app/v1/verify/[email protected]" \
  -H "X-API-Key: your-api-key"

Pruébalo

Clave API

Necesita una clave API para probar los puntos finales.

Dirección de correo o dominio

Prueba con:

Lista blanca y lista negra

Controle qué correos y dominios se bloquean con reglas de lista negra y blanca por usuario. Estas listas definen el campo block en cada respuesta de verificación.

{}

El campo block

Cada respuesta de verificación incluye un campo block. Use este campo para decidir si debe bloquear el email/dominio según sus listas:

trueEl email o su dominio está en la lista negra → block: true. Añadir un dominio bloquea todos los correos en él.

trueLa lista blanca está activa pero el email/dominio no está en ella → block: true.

falseLa lista blanca está activa y el email o su dominio está en ella → block: false.

—Ninguna lista aplica → block sigue el resultado normal de verificación.

Resumen

✘

Lista negra

Bloquear siempre correos o dominios concretos. Por ejemplo, añadir example.com a la lista negra hace que cualquier correo @example.com devuelva block: true, sin importar el resultado de la verificación.

✔

Lista blanca

Permitir solo correos o dominios concretos. Con la lista blanca activa, solo las entradas de la lista reciben block: false; todo lo demás block: true. Por ejemplo, añadir gmail.com permite cualquier @gmail.com, pero [email protected] se bloquearía. Desactivada, la lista blanca no tiene efecto.

Puede añadir un email completo ([email protected]) o un dominio (example.com). Añadir un dominio aplica a todos los correos de ese dominio. No se distingue mayúsculas de minúsculas.

Cómo funciona

Orden de evaluación

Primero lista negra — Si el correo o su dominio está en la lista negra, el resultado es block: true. No se aplica más lógica de listas.

Lista blanca (si está activa) — Si el email/dominio está en la lista blanca → block: false. Si no → block: true.

Lista blanca desactivada — Solo aplican la lista negra y la verificación normal.

La lista negra siempre gana: una dirección en la lista negra sigue bloqueada aunque esté también en la blanca.

Qué se comprueba

Verificación de email: la API comprueba la dirección completa y el dominio contra ambas listas. Cualquier coincidencia aplica la regla de la lista.

Verificación de dominio: solo se comprueba el dominio contra la lista negra y (si está activa) la blanca.

Referencia rápida

Lista blanca activa	En lista negra	En lista blanca	valor de block
No	Sí	—	`true`
No	No	—	Normal
Sí	Sí	Cualquiera	`true`
Sí	No	Sí	`false`
Sí	No	No	`true`

Endpoints de listas API

Todos los endpoints de listas requieren el encabezado: X-API-Key: your-api-key

Lista negra

GET/v1/blacklist

Listar entradas de la lista negra

POST/v1/blacklist

Añadir email o dominio · { "value": "..." }

DELETE/v1/blacklist

Eliminar entrada · value=...

Lista blanca

GET/v1/whitelist

Listar entradas de la lista blanca

POST/v1/whitelist

Añadir email o dominio · { "value": "..." }

DELETE/v1/whitelist

Eliminar entrada · value=...

GET/v1/whitelist/enabled

Obtener estado de lista blanca · { "enabled": boolean }

PUT/v1/whitelist/enabled

Activar/desactivar lista blanca · { "enabled": true | false }

Ejemplos de códigos (cURL)

✘

Lista negra

GET/v1/blacklist

Listar entradas de la lista negra

curl "https://api.verify-email.app/v1/blacklist" \
  -H "X-API-Key: your-api-key"

POST/v1/blacklist

Añadir email o dominio

curl -X POST "https://api.verify-email.app/v1/blacklist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/blacklist

Eliminar entrada

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

✔

Lista blanca

GET/v1/whitelist

Listar entradas de la lista blanca

curl "https://api.verify-email.app/v1/whitelist" \
  -H "X-API-Key: your-api-key"

POST/v1/whitelist

Añadir email o dominio

curl -X POST "https://api.verify-email.app/v1/whitelist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/whitelist

Eliminar entrada

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

GET/v1/whitelist/enabled

Obtener estado de lista blanca

curl "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "X-API-Key: your-api-key"

PUT/v1/whitelist/enabled

Activar/desactivar lista blanca

curl -X PUT "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "enabled": true
  }'

Formato del valor

[email protected] — Email: formato válido, ej. [email protected]
example.com — Dominio: formato válido, ej. example.com

Valores no válidos se rechazan con 400. Las entradas se almacenan normalizadas. Los duplicados se fusionan en una sola entrada.

Dónde se aplican las listas

Las reglas de listas se aplican tras la verificación. Las respuestas de verificación de email (simple y por lotes) y de dominio ya incluyen la lista negra y blanca del usuario en el campo block.

Servidor MCP (integración del agente AI)

Integre la verificación de correos electrónicos directamente en agentes de IA como Cursor y Claude Desktop mediante el protocolo de contexto de modelo (MCP). Tu asistente de IA puede verificar correos electrónicos, comprobar dominios y validar la sintaxis sin salir del editor.

Docs endpoint for AI agents

The API exposes a machine-readable docs endpoint (no API key required) so AI agents and MCP clients can discover the server, available tools, and auth requirements. Use this URL in your agent or MCP configuration.

GET /v1/mcp/docs

Returns JSON with server name, description, serverUrl, docsEndpoint, authentication details, and full tool definitions.

curl "https://api.verify-email.app/v1/mcp/docs"

AI agents can GET this URL to receive server metadata, tool schemas, and integration instructions in JSON. No authentication is required for the docs endpoint.

Open docs endpoint How to add in Cursor How to add in Claude

Integration details

Authentication

All MCP tool calls require your API key in the X-API-Key header. Get your key from the dashboard.

MCP server URL: https://api.verify-email.app/mcp

Docs endpoint (for agents): https://api.verify-email.app/v1/mcp/docs

Cursor

Add the server in Cursor Settings → Tools & MCP, or add the config to .cursor/mcp.json in your project or home directory.

Claude Desktop

Add the server to your Claude Desktop config (mcpServers in claude_desktop_config.json). Use the server URL and X-API-Key header as shown below.

Response format

Tool results match the REST API response shape (valid, block, deliverable, remaining_credits, etc.). Use the block field for blacklist/whitelist decisions.

This MCP server is production-ready and uses the same API as the REST endpoints. Credits are consumed per verification as with the REST API.

Configurar

Añada la siguiente configuración a su archivo .cursor/mcp.json o Claude Desktop config:

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Herramientas disponibles

Herramienta	Descripción	Entrada	Créditos
verify_email	Verificación completa del correo electrónico, incluidas comprobaciones de sintaxis, MX, SMTP, desechables, de privacidad y de entregabilidad.	{ email: string }	1
verify_domain	Verificación completa de dominios, incluidos registros MX, desechables, privacidad y detección de catch-all.	{ domain: string }	1
check_deliverability	Comprobación rápida de la entregabilidad mediante verificación MX y SMTP sin llamadas a API externas	{ email: string }	1
verify_batch	Verificación por lotes de hasta 100 correos electrónicos o dominios en una sola solicitud	{ inputs: string[] }	1 per item
validate_email_syntax	Validación rápida de la sintaxis local según RFC 5322 sin llamadas a la red	{ email: string }	0 (free)