¿Cuánto cuesta una verificación API?

Un POST /verify exitoso usa exactamente 1 credit. Las solicitudes GET (saldo, historial) son gratuitas. Los créditos no caducan — solo compras lo que necesitas.

¿Puedo verificar el mismo email varias veces?

Sí. Cada llamada API /verify usa 1 credit, incluso para la misma dirección. La facturación es predecible y alineada con el uso real.

¿Cómo genero una clave API?

Crea una cuenta, abre API tokens (/account/api), haz clic en «New token» y copia el secret ev_live_… o ev_test_… (sandbox). La clave completa se muestra solo una vez.

¿La API admite verificación bulk de email?

Sí. POST /bulk acepta hasta 50.000 direcciones. El coste es N créditos por N emails. Sigue el progreso con GET /bulk/:id y descarga resultados CSV.

¿Qué significan valid, invalid y risky?

valid — listo para enviar; invalid — eliminar; risky — disposable o role account; catch_all — el dominio acepta todas las direcciones. Ver sección Estados.

¿Hay límite de solicitudes por minuto?

60 solicitudes/min por clave API por defecto. La respuesta 429 devuelve error: rate_limit_exceeded. Usa Idempotency-Key al reintentar POST /verify.

¿Dónde está la especificación OpenAPI completa?

Descarga openapi-v1.yaml en /api/v1/openapi.yaml o usa Redoc interactivo en /es/dokumentacja-api/reference.

Centro para desarrolladores · REST API v1

API de verificación de direcciones de email

Verifica listas de correo de forma programática — menos rebotes, mejor entregabilidad

Conecta formularios de registro, CRMs y landing pages a EmailVerifier. Comprueba direcciones de email vía REST API en tiempo real o en jobs bulk — con facturación transparente 1 request = 1 credit.

Verificación en tiempo real
Bulk hasta 50.000 emails
1 solicitud = 1 crédito

Generar clave API Crear cuenta OpenAPI / Redoc

Ejemplo de solicitud

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_…" \
  -d '{"email":"user@company.com"}'

Base de conocimiento API

Elige un tema — desde autenticación y créditos hasta jobs bulk, webhooks y códigos de error.

APIAPI de verificación de email

POST /verify — una dirección, resultado en subsegundos, estado valid/invalid/risky.

APIVerificación bulk de email

Verifica listas CSV masivamente — cola de jobs, polling de progreso y exportación CSV.

APICréditos y facturación

Saldo, uso de API, 1 credit = 1 verificación, manejo de HTTP 402.

APIClaves API y autenticación

Bearer ev_live_, panel de tokens, mejores prácticas de almacenamiento seguro.

APIWebhooks e integraciones

verification.completed, firma HMAC, CRM y automatización de marketing.

APIReferencia OpenAPI

Especificación YAML completa, UI Redoc y catálogo de errores HTTP.

¿Qué es una API de verificación de email?

Una interfaz REST para validar direcciones antes de enviar campañas.

Una API de verificación de email comprueba si una dirección existe, si el dominio acepta correo y si la bandeja es disposable o catch-all. Reduces la tasa de rebote, proteges la reputación del remitente y mejoras la entrega en bandeja de entrada.

La API se sirve por HTTPS en /api/v1. Autentícate con una clave Bearer (ev_live_…) o sesión del panel. Cada POST /verify exitoso cuesta un credit — sin suscripción ni cargos ocultos en solicitudes GET.

Cuándo usar una API validadora de email

Escenarios de integración habituales en productos B2B y stacks de marketing.

Formularios de registro

Valida el email en tiempo real al registrarse — rechaza invalid y disposable antes de insertar en la lista.

CRM y captura de leads

Limpia leads de landing pages y webhooks — solo direcciones entregables entran en tu pipeline.

Higiene de listas antes de campañas

Bulk API antes de newsletters — menos rebotes, mayor open rate y menor coste ESP.

Plataformas SaaS

Integra comprobaciones de email en tu producto — la facturación por créditos simplifica el pricing para clientes.

Modelo de créditos API

Precios simples: una solicitud de verificación = un credit.

POST /verify cobra 1 credit por solicitud exitosa (HTTP 200) con claves ev_live_, incluso si la misma dirección se verificó antes vía API. Las claves sandbox (ev_test_) devuelven resultados mock sin debitar créditos.
Las operaciones GET — saldo, historial, estado de job bulk, exportación CSV — son gratuitas.
Saldo insuficiente devuelve HTTP 402 (insufficient_credits). Errores del motor (503) no cobran credit.

Autenticación y claves API

Acceso seguro mediante el header Authorization.

Inicia sesión en el panel y abre API tokens (/account/api).
Crea una clave de producción (ev_live_) o de prueba sandbox (ev_test_) en el panel — el secret completo se muestra solo una vez.
Envía la clave como Authorization: Bearer ev_live_… — nunca en URLs ni código del cliente.

Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/json

Inicio rápido — API de verificación de email

Dos llamadas: comprobación de saldo y primera verificación.

1. Comprobar saldo de créditos

curl https://propercheck.pl/api/v1/credits \
  -H "Authorization: Bearer ev_live_YOUR_KEY"

2. Verificar una dirección de email

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

Verificación única (tiempo real)

POST /api/v1/verify acepta JSON con un campo email. La respuesta incluye status, score 0–100, provider (Google, Microsoft, hosts regionales) y enrichment (MX, catch-all).

POST /api/v1/verify

Estructura de respuesta JSON

Campos devueltos tras una verificación exitosa.

{
  "verificationId": "ver_abc123",
  "email": "john@company.com",
  "status": "valid",
  "score": 92,
  "provider": "google",
  "enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
  "creditsRemaining": 149
}

Estados de verificación de email

Clasificación usada en API, panel y exportaciones CSV.

valid

valid — la dirección existe y puede recibir correo; seguro para enviar.

invalid

invalid — la dirección no existe o el dominio no tiene correo; eliminar de la lista.

risky

risky — baja confianza (p. ej. disposable, role account); precaución en campañas.

catch_all

catch_all — el servidor acepta todas las direcciones del dominio; mayor riesgo de rebote.

unknown

unknown — respuesta SMTP no concluyente; considera reverificación más tarde.

Referencia de endpoints REST

Lista completa de rutas API v1 con coste en créditos.

Método	Ruta	Créditos	Descripción
POST	/verify	1	Verificación de email única en tiempo real
GET	/verify/:id	0	Obtener resultado por verificationId
GET	/verifications	0	Historial de verificaciones y estadísticas de 30 días
GET	/credits	0	Saldo actual de créditos de la cuenta
POST	/bulk	N	Crear job bulk (N créditos)
GET	/bulk/:id	0	Estado y progreso del job bulk
GET	/bulk/:id/export	0	Descargar resultados como CSV
GET/POST/PATCH/DELETE	/api-keys	0	Gestión de tokens API (sesión)
GET/POST/DELETE	/webhooks	0	Configuración de webhooks (sesión)
GET	/usage	0	Estadísticas de uso de API y créditos

API de verificación bulk de email

Verifica miles de direcciones en un job — ideal antes de campañas grandes.

POST /bulk con array emails o texto CSV — créditos reservados para N direcciones únicas.
GET /bulk/:id — polling de estado (queued → processing → completed).
GET /bulk/:id/export — descarga CSV con columnas email, status, score, provider.

curl -X POST https://propercheck.pl/api/v1/bulk \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@b.co","c@d.co"]}'

Webhooks — evento verification.completed

Recibe un POST en tu URL cuando la verificación termina. El header X-EV-Signature contiene HMAC-SHA256 del body — verifica antes de procesar.

X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>

Límites de tasa

60 solicitudes por minuto por clave API por defecto. Superar el límite devuelve HTTP 429 con rate_limit_exceeded. Los límites son por clave — usa tokens separados por integración.

Header opcional en POST /verify — reintentos seguros sin doble débito de credit para la misma clave (TTL 24h).

X-Request-Id

Cada respuesta API incluye X-Request-Id — inclúyelo al contactar soporte para depurar la integración.

Códigos de error HTTP

HTTP	Código	Descripción
401	unauthorized	Falta sesión o clave API en la solicitud.
401	invalid_api_key	Clave API inválida, expirada o revocada.
400	invalid_request	JSON inválido, falta el campo email o dirección mal formada.
402	insufficient_credits	Créditos insuficientes — recarga en /account/credits.
429	rate_limit_exceeded	Límite de tasa superado — 60 solicitudes/min por clave API por defecto.
503	engine_unavailable	Motor de verificación no disponible — no se cobra credit.

Ejemplos de integración

El mismo flujo de verificación en lenguajes populares.

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

FAQ — API de verificación de email

Preguntas frecuentes de desarrolladores y marketers.

OpenAPI 3.1 y Redoc

Especificación legible por máquina para codegen, pruebas de contrato y pipelines CI.

Descargar openapi-v1.yaml Referencia interactiva Redoc

Empieza a verificar emails vía API

Créditos de prueba gratis al registrarte. Clave API en tu panel en un minuto.

Crear cuenta Tokens API

Genera tu clave en el panel de cuenta.