API de alquiler de números telefónicos

Alquila números, lee SMS entrantes, extiende y cancela desde tu propio código. JSON sobre HTTPS con una clave API de la consola.

URL base: https://snsnumber.com/api/v1
Autenticación: Authorization: Bearer snk_...
Límite de tasa: 300 solicitudes por minuto por clave

Crea la clave en la consola bajo API. Los precios están en dólares estadounidenses como cadenas con dos decimales. Las horas son ISO 8601 en UTC.

Endpoints

GET/balanceTu saldo en dólares estadounidenses.

{ "balance": "120.00", "currency": "USD" }

GET/prices?country=usPaíses, períodos y precios. Omite el país para ver todos.

{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }

POST/rentalsAlquila un número. Cuerpo: país y días.

curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }

GET/rentals?state=activeTus alquileres, los más nuevos primero (estado: activo, caducado, cancelado).

{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }

GET/rentals/{id}Un alquiler con su bandeja de entrada.

{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }

POST/rentals/{id}/extendAñadir un período a un alquiler activo. Cuerpo: días.

{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }

POST/rentals/{id}/cancelReembolso completo dentro de 20 minutos si no ha llegado ningún SMS.

{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

Errores

Los errores devuelven un estado HTTP y un { "error": { "code", "message" } }.

Estado	Código	Significado
401	no_key, bad_key	Clave API faltante o incorrecta
402	no_balance	Saldo insuficiente
404	not_found	Alquiler no encontrado
409	ended, cancel_denied	El alquiler terminó o ha pasado el plazo de cancelación
429	rate_limited, too_many_active	300 solicitudes por minuto, o 20 números activos
503	network_error	Inténtalo de nuevo en un momento