API de verificación por email
Compra direcciones de email desechables para verificación OTP a través de una API REST limpia. Las mismas convenciones JSON y la misma clave de API que los endpoints de SMS, dentro de /v1/email-activations.
URL base
https://smsbulk.net/api/v1/email-activationsUna sola clave de API funciona para SMS y email. Si ya integraste la API de SMS, el email funciona con la misma clave.
Autenticación
Envía tu clave de API en cada solicitud. Se aceptan dos métodos intercambiables:
# 1. Header (recommended)
curl https://smsbulk.net/api/v1/email-activations \
-H "x-api-key: YOUR_KEY"
# 2. Bearer token
curl https://smsbulk.net/api/v1/email-activations \
-H "Authorization: Bearer YOUR_KEY"Envía la clave mediante el encabezado (x-api-key) o un token Bearer. No se recomienda pasarla como parámetro de consulta en la URL por seguridad, ya que las cadenas de consulta suelen registrarse en los logs del servidor y del proxy.
Tu clave de API de SMS es la misma que se usa aquí. No hay una clave de email separada.
Endpoints
Seis rutas bajo /api/v1/email-activations. Los precios son los de cara al usuario; el coste mayorista nunca se devuelve.
Lista los dominios de proveedores de email disponibles para un sitio objetivo, con precio de usuario y stock.
curl "https://smsbulk.net/api/v1/email-activations/domains?site=telegram.com" \
-H "x-api-key: YOUR_KEY"[
{ "name": "gmx.com", "price": 0.04, "count": 12, "currency": "USD" }
]Reserva una dirección de email para un par sitio/dominio. Cobra tu monedero de inmediato y devuelve la activación en WAITING.
curl -X POST https://smsbulk.net/api/v1/email-activations \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "site": "telegram.com", "domain": "gmx.com" }'{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "WAITING",
"otpValue": null,
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:05:00Z",
"createdAt": "2026-06-03T13:45:00Z"
}Devuelve tus activaciones de email más recientes, las más nuevas primero. Por defecto 50, máximo 100, sin paginación por cursor.
curl "https://smsbulk.net/api/v1/email-activations?limit=50" \
-H "x-api-key: YOUR_KEY"[
{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "RECEIVED",
"otpValue": "595348",
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:05:00Z",
"receivedAt": "2026-06-03T13:47:12Z",
"createdAt": "2026-06-03T13:45:00Z",
"reorderBlockedAt": null
}
]Obtiene una sola activación. Incluye el OTP analizado y el cuerpo HTML original del email una vez recibido.
curl https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
-H "x-api-key: YOUR_KEY"{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "RECEIVED",
"otpValue": "595348",
"htmlMessage": "<html>Your code is 595348</html>",
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:05:00Z",
"receivedAt": "2026-06-03T13:47:12Z",
"createdAt": "2026-06-03T13:45:00Z",
"reorderBlockedAt": null
}Vuelve a abrir la misma dirección para otro OTP. Cobra el monedero de nuevo (equivalente al reenvío de SMS para email).
curl -X POST https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd/reorder \
-H "x-api-key: YOUR_KEY"{
"id": "cmox8h7pmicm3mkczzwhdz0yd",
"site": "telegram.com",
"domain": "gmx.com",
"emailAddress": "a1b2c3@gmx.com",
"status": "WAITING",
"otpValue": null,
"userCost": "0.04",
"currency": "USD",
"expiresAt": "2026-06-03T14:20:00Z",
"createdAt": "2026-06-03T13:45:00Z",
"reorderBlockedAt": null
}Si el proveedor de correo bloqueó la dirección, reorder falla con 502 y el código EMAIL_BANNED, y el cargo se reembolsa. A partir de entonces la activación incluye reorderBlockedAt (una fecha ISO, o null) en las respuestas de lista, detalle y reorder, y cada nuevo reorder devuelve 409 con el código EMAIL_BANNED sin cobrar. Compra una nueva dirección.
HTTP 409 Conflict
{
"statusCode": 409,
"code": "EMAIL_BANNED",
"message": "Email address blocked by the provider; reorder is not possible"
}Cancela una activación. Reembolsa tu monedero si no se recibió ningún OTP.
curl -X DELETE https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
-H "x-api-key: YOUR_KEY"{
"ok": true
}Si un reorder de esta activación quedó atascado, la cancelación reembolsa el cargo del reorder en lugar de cancelar. La respuesta es 200 con reorderRefunded: true y el código EMAIL_REORDER_REFUNDED, y la dirección original sigue activa.
HTTP 200 OK
{
"ok": true,
"reorderRefunded": true,
"code": "EMAIL_REORDER_REFUNDED",
"message": "Reorder failed and was refunded. Your original email address is still active."
}Si todavía hay un reorder en curso en esta activación, la cancelación devuelve 409 con el código EMAIL_REORDER_IN_PROGRESS y retryAfterSec (segundos de espera). No se cancela ni se cobra nada; vuelve a intentarlo pasado ese tiempo.
HTTP 409 Conflict
{
"statusCode": 409,
"code": "EMAIL_REORDER_IN_PROGRESS",
"message": "A reorder is in progress. Try again in a moment.",
"retryAfterSec": 90
}Notas y límites
- La cuota diaria se comparte entre SMS y email: 10.000 solicitudes por clave de API por día UTC.
- El endpoint de lista devuelve como máximo 100 filas (por defecto 50) y, por diseño, no tiene paginación por cursor.
- Los descuentos de fidelidad se aplican automáticamente al precio cobrado. userCost refleja lo que realmente pagas.
Empieza a verificar por email
Consigue tu clave de API y envía tu primera solicitud con un solo comando curl.