La API de NeuraMail te permite verificar direcciones de email y consultar tu cuenta de forma programática. Todos los endpoints devuelven JSON. La autenticación es mediante una API key por usuario.
https://neuramail.clIncluye tu API key en cada solicitud usando la cabecera Authorization. Genera o rota tu clave desde la página API Keys del panel.
Authorization: Bearer nm_live_xxxxxxxxxxxxxxxxxxxx
Mantén tu API key en secreto. Nunca la expongas en código del lado del cliente o repositorios públicos. Rótala inmediatamente si sospechas que ha sido comprometida.
/api/v1/verifyVerifica una sola dirección de email. Devuelve estado, sub-estado, información MX y si el resultado fue cacheado.
Parámetros
emailRespuesta
{
"success": true,
"data": {
"email": "[email protected]",
"status": "valid",
"score": 95,
"mx_found": true,
"smtp_valid": true,
"is_disposable": false,
"is_role_based": false,
"is_catch_all": false,
"provider": "google",
"from_cache": false
}
}/api/v1/creditsDevuelve el saldo de créditos actual y el historial de transacciones recientes del usuario autenticado.
Respuesta
{
"success": true,
"data": {
"credits": 48200,
"subscription_credits": 48200,
"permanent_credits": 0,
"subscription_expires_at": "2026-08-26T19:38:13.275Z",
"recent_transactions": [
{ "amount": -4, "type": "verification", "description": null, "created_at": "2026-07-26T10:00:00Z" }
]
}
}/api/v1/emailsEnvía un email transaccional (confirmaciones, recuperación de contraseña, enlaces de firma, etc.). El dominio del campo from debe estar verificado en tu cuenta. Consume 1 crédito por envío.
Parámetros
fromtosubjecthtmltextreply_totagsEjemplo (cURL)
curl -X POST https://neuramail.cl/api/v1/emails \
-H "Authorization: Bearer nm_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"from":"Mi App <[email protected]>","to":"[email protected]","subject":"Hola","html":"<p>Hola</p>"}'Respuesta
{
"data": {
"id": "9f1c8e2a-...",
"from": "Mi App <[email protected]>",
"to": ["[email protected]"],
"created_at": "2026-06-30T20:00:00Z"
}
}/api/v1/emails?limit=50Lista los últimos emails enviados (máx. 100).
Alternativa a la API HTTP: usa cualquier librería SMTP estándar (nodemailer, PHPMailer, etc.). El usuario puede ser cualquier valor; la contraseña es tu API key. Mismas reglas: el dominio del remitente debe estar verificado.
host: smtp.neuramail.cl port: 587 # STARTTLS user: apikey # cualquier valor pass: nm_live_xxxxxxxxxxxxxxxx # tu API key
validEl buzón existe y es probable que reciba correo.invalidEl buzón no existe o el dominio no funciona.riskyCuenta de rol, recientemente desactivada o resultado de baja confianza.catch_allEl servidor acepta todo el correo; no se puede confirmar el buzón individual.unknownEl servidor agotó el tiempo de espera o bloqueó el handshake de verificación.Sub-estados
disposablerole_basedspam_trapmx_not_foundsmtp_errorbouncesyntax_error400Bad RequestParámetros faltantes o inválidos.401No autorizadoAPI key faltante o inválida.402Créditos insuficientesEl saldo de tu cuenta es muy bajo.422Entidad no procesableLa dirección de email falló la validación de sintaxis.429Demasiadas solicitudesLímite de velocidad excedido. Reintenta después del valor del encabezado Retry-After.500Error del servidorError inesperado. Contacta soporte si persiste.