SMSREC
Iniciar sesiónRecargar saldo
REST API v1

Automatiza activaciones de SMS

Usa una API para saldo, precios actualizados, compra de números virtuales y códigos de verificación. Las mismas reglas de saldo y reembolso automático aplican al panel y la API.

Obtener una clave de APIhttps://smsrec.com/api/v1

Autenticación

Crea o rota tu clave en Configuración de cuenta. Envíala en el encabezado Authorization. La clave completa solo se muestra una vez; SMSREC solo almacena su hash criptográfico.

Authorization: Bearer smsrec_live_YOUR_API_KEY
Mantén la clave en tu servidor. Nunca la incrustes en código de aplicación web o móvil.

Errores, límites e idempotencia

Las respuestas son JSON e incluyen un booleano ok. El límite actual es 60 solicitudes por minuto por clave de API. Las solicitudes de compra requieren una Idempotency-Key única para que un reintento de red no compre el mismo número dos veces.

{ "ok": false, "error": {"code": "insufficient_balance", "message": "Not enough balance."} }

GET/api/v1/balance

Devuelve el saldo actual de la cuenta.

curl https://smsrec.com/api/v1/balance \ -H "Authorization: Bearer $SMSREC_API_KEY"

GET/api/v1/services

Devuelve todos los servicios con stock actual y su precio más bajo actual.

GET/api/v1/prices?service=telegram

Devuelve hasta 500 ofertas actuales de servicio-país. Proporciona servicio, país, o ambos. Cada oferta incluye success_rate: el porcentaje de entregas exitosas de SMS, o null si no se conoce.

POST/api/v1/activations

service requerido — código de servicio del endpoint services
country requerido — código de país del endpoint prices
Idempotency-Key encabezado requerido — un valor único para este intento de compra
curl -X POST https://smsrec.com/api/v1/activations \ -H "Authorization: Bearer $SMSREC_API_KEY" \ -H "Idempotency-Key: order-2026-0001" \ -H "Content-Type: application/json" \ -d '{"service":"telegram","country":"indonesia"}'

GET/api/v1/activations/{id}

Consulta cada 3–5 segundos. Cuando el SMS llegue, el estado cambia a received y code contiene el código de verificación.

{ "ok": true, "activation": { "id": 42, "phone": "+628123456789", "status": "received", "code": "482913", "price_usd": "0.68" } }

POST/api/v1/activations/{id}/cancel

Cancela una activación en espera y devuelve su precio a tu saldo de SMSREC. Una activación recibida se completa sin reembolso.

curl -X POST https://smsrec.com/api/v1/activations/42/cancel \ -H "Authorization: Bearer $SMSREC_API_KEY"