API

REST API para solicitar números virtuales, consultar SMS, administrar rentas y recargar la cartera. Los mismos endpoints que usa el panel — autenticación bearer-token, JSON entrada y salida, sin SDK requerido.

Autenticación

Genera un token API personal desde Panel → Tokens API. Inclúyelo como header bearer en cada solicitud:

Authorization: Bearer <your-token>

URL base

https://smsactivator.io

Endpoints

  • GET/v1/servicesLista servicios soportados con precios actuales por país.
  • GET/v1/countriesLista países con inventario activo.
  • POST/v1/ordersSolicita un número virtual. Body: { serviceSlug, countryIso }. Retorna el número asignado e orderId.
  • GET/v1/orders/:idConsulta el estado de recepción de SMS. Retorna { status, sms, expiresAt }.
  • DELETE/v1/orders/:idCancela una orden activa. Reembolsa la cartera si no hay SMS aún.
  • POST/v1/paymentsCrea una factura de depósito cripto. Body: { provider, amountUsd, cryptoCurrency? }. Retorna el payLink de OxaPay.
  • GET/v1/walletObtén saldo actual de cartera y transacciones recientes.
  • GET/v1/rentalsLista rentas activas a largo plazo.

Inicio rápido

curl -X POST https://smsactivator.io/v1/orders \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serviceSlug":"telegram","countryIso":"US"}'

Límites de tasa

  • Colocación de órdenes: 30 solicitudes / minuto / token
  • Consulta de órdenes: 120 solicitudes / minuto / token
  • Pagos / depósitos: 10 solicitudes / hora / token
  • Fallback global por IP: 120 solicitudes / minuto (aplica incluso sin token)

Al alcanzar un límite retorna HTTP 429 con un header Retry-After.

¿Necesitas un límite mayor?

Contacta @smsactivator_support con tu caso de uso. Planes reseller e integración obtienen 10x presupuesto de ráfaga en endpoints de órdenes.