REST API · Email

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-activations

Una sola clave de API funciona para SMS y email. Si ya integraste la API de SMS, el email está a minutos de distancia.

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.

GET/api/v1/email-activations/domains?site=telegram.com

Lista los dominios de proveedores de email disponibles para un sitio objetivo, con precio de usuario y stock.

Solicitud

curl "https://smsbulk.net/api/v1/email-activations/domains?site=telegram.com" \
  -H "x-api-key: YOUR_KEY"

Respuesta

[
  { "name": "gmx.com", "price": 0.04, "count": 12, "currency": "USD" }
]

POST/api/v1/email-activations

Reserva una dirección de email para un par sitio/dominio. Cobra tu monedero de inmediato y devuelve la activación en WAITING.

Solicitud

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" }'

Respuesta

{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": null,
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}

GET/api/v1/email-activations?limit=50

Devuelve tus activaciones de email más recientes, las más nuevas primero. Por defecto 50, máximo 100, sin paginación por cursor.

Solicitud

curl "https://smsbulk.net/api/v1/email-activations?limit=50" \
  -H "x-api-key: YOUR_KEY"

Respuesta

[
  {
    "id": "cmox8h7pmicm3mkczzwhdz0yd",
    "site": "telegram.com",
    "domain": "gmx.com",
    "emailAddress": "[email protected]",
    "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"
  }
]

GET/api/v1/email-activations/:id

Obtiene una sola activación. Incluye el OTP analizado y el cuerpo HTML original del email una vez recibido.

Solicitud

curl https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"

Respuesta

{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": "[email protected]",
  "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"
}

POST/api/v1/email-activations/:id/reorder

Vuelve a abrir la misma dirección para otro OTP. Cobra el monedero de nuevo (equivalente al reenvío de SMS para email).

Solicitud

curl -X POST https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd/reorder \
  -H "x-api-key: YOUR_KEY"

Respuesta

{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": null,
  "status": "WAITING",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:20:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}

DELETE/api/v1/email-activations/:id

Cancela una activación. Reembolsa tu monedero si no se recibió ningún OTP.

Solicitud

curl -X DELETE https://smsbulk.net/api/v1/email-activations/cmox8h7pmicm3mkczzwhdz0yd \
  -H "x-api-key: YOUR_KEY"

Respuesta

{
  "id": "cmox8h7pmicm3mkczzwhdz0yd",
  "site": "telegram.com",
  "domain": "gmx.com",
  "emailAddress": null,
  "status": "REFUNDED",
  "otpValue": null,
  "userCost": "0.04",
  "currency": "USD",
  "expiresAt": "2026-06-03T14:05:00Z",
  "receivedAt": null,
  "createdAt": "2026-06-03T13:45:00Z"
}

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.

Obtener clave de API Abrir Swagger Volver a la documentación