Documentación de Mailbeam
Todo lo que necesitas para integrar la verificación de email en tiempo real en tu aplicación.
Mailbeam es una API REST para comprobar si una dirección de email puede recibir correo de verdad. Envías una dirección a POST /v1/verify y recibes un estado, una puntuación y el motivo que hay detrás, o mandas hasta 500 000 direcciones a POST /v1/verify/batch y recoges los resultados de forma asíncrona. La autenticación es un token Bearer; no hay nada más que instalar.
- URL base
- https://api.mailbeam.dev
- Versión actual
- /v1/ — 12 meses de aviso de obsolescencia
- Autenticación
- Authorization: Bearer mb_live_…
- Tope por lote
- 500 000 direcciones por trabajo
Inicio rápido
Tu primera verificación en 5 minutos.
Autenticación
Claves de API, tokens Bearer y rotación de claves.
Límites de tasa
Cuotas, cabeceras y estrategia de reintentos.
Errores
Códigos de error, estructura y cómo tratarlos.
Webhooks
Entrega de eventos en tiempo real y verificación HMAC.
SDKsPrevisto
Bibliotecas oficiales para Node, Python, PHP, Ruby y Go.
¿Buscas la referencia de la API?
Documentación completa de los endpoints, con esquemas de petición y respuesta y ejemplos interactivos.
Ir a la referencia de la API¿Vienes de otro proveedor?
Preguntas frecuentes
¿La API de Mailbeam está disponible ahora mismo?
Sí. La API pública está abierta a cualquiera que se registre. El plan Free cubre 1.000 verificaciones al mes sin tarjeta, y tienes una clave de API esperándote en el panel la primera vez que entras.
¿Qué necesito para hacer mi primera llamada a la API de Mailbeam?
Una clave de API, enviada como token Bearer en la cabecera Authorization, y una petición JSON a un endpoint bajo https://api.mailbeam.dev/v1/. El inicio rápido recorre una verificación completa de principio a fin.
¿Cómo versiona Mailbeam su API?
La versión actual es v1 y todos los endpoints cuelgan de /v1/. Mantenemos la compatibilidad hacia atrás dentro de una versión; los cambios que la rompen van a una versión nueva, y la antigua se marca como obsoleta con al menos 12 meses de aviso.
¿Qué diferencia hay entre la verificación en tiempo real y la verificación por lotes?
La verificación en tiempo real usa POST /v1/verify, responde por una dirección en cada petición y no almacena ninguna dirección. La verificación por lotes usa POST /v1/verify/batch, acepta hasta 500 000 direcciones por trabajo, se ejecuta de forma asíncrona y guarda los resultados 72 horas para que puedas recogerlos.
Respuestas contrastadas con el contrato de la API el .