Ir al contenido
tomnumber

API de verificación por SMS

Compra números y lee códigos desde tu propio software. La API usa tu saldo, los mismos precios y la misma regla de reembolso de 20 minutos que el sitio web.

La clave de API se crea dentro de tu cuenta. Los números comprados por la API salen del mismo saldo y cuestan lo mismo que en el sitio web.

Crear una cuentaClave de API

Desde $0.0018 por número

Datos clave

Precio más bajo por número
$0.0018
Autenticación
Clave de API
Formato
JSON sobre HTTPS
Límite de solicitudes
120 solicitudes por minuto
Reembolso
Igual que en el sitio web

REST y JSON

Seis solicitudes cubren saldo, servicios, precios, obtener un número, estado y cancelación.

Una clave de tu cuenta

Crea una clave en la página Clave de API de tu cuenta y envíala en el encabezado Authorization.

Mismos precios que el sitio

Los precios de los números y la regla de reembolso de 20 minutos son los mismos que en la web.

¿Qué solicitudes puedo enviar?

Las rutas van después de la URL base. Cada solicitud necesita tu clave de API.

¿Qué solicitudes puedo enviar?
Método y rutaQué hace
GET/balanceTu saldo en USD
GET/servicesTodos los servicios con el precio más bajo y la cantidad de países
GET/prices?service=telegramEl precio de un número en cada país para un servicio
POST/numbersObtiene un número para un servicio y un país; el precio se descuenta de tu saldo
GET/numbers/{id}Estado de un número y todos los códigos recibidos hasta ahora
POST/numbers/{id}/cancelCancela antes de que llegue un código; el precio vuelve a tu saldo

¿En qué orden llamo a la API?

  1. 1

    Obtén un número POST /numbers con service y country. Guarda el id y el número.

  2. 2

    Ingresa el número Escribe el número en el servicio que envía el código.

  3. 3

    Consulta el código GET /numbers/{id} cada 5 segundos hasta que la lista codes no esté vacía.

  4. 4

    Termina Usa el código. Si ya no necesitas el número antes de que llegue un código, cancélalo.

¿Cómo obtengo una clave de API?

Inicia sesión y abre Clave de API en tu cuenta. Crea una clave y cópiala enseguida; solo se muestra una vez. Al crear una clave nueva, la anterior deja de funcionar.

Clave de API

¿Cuál es la URL base?

Envía cada solicitud a esta dirección con la clave en el encabezado Authorization (Bearer) o en el encabezado X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Campos de la solicitud

Campos de la solicitud
CampoSe usa enValor
servicePOST /numbers, GET /pricesNombre del servicio según /services, p. ej. telegram
countryPOST /numbersCódigo de país de dos letras, p. ej. gb

Campos de respuesta y estados

Campos de respuesta y estados
ValorSignificado
waitingEl número está activo y todavía no llegó ningún código
receivedLlegó al menos un código; pueden llegar más hasta expires_at
refundedSin código en 20 minutos; el precio volvió a tu saldo
canceledCancelaste antes de que llegara un código; el precio volvió a tu saldo

Ejemplo de respuesta

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Códigos de error

Códigos de error
unauthorizedFalta la clave de API o es incorrecta
rate_limitedMás de 120 solicitudes en un minuto
bad_serviceNombre de servicio desconocido
bad_countryPaís no disponible para ese servicio
low_balanceEl saldo es menor que el precio
unavailableNo hay números disponibles ahora. No se cobró nada
not_foundNo hay ningún número con ese id en tu cuenta
cannot_cancelYa llegó un código o el número está cerrado

Ejemplos de código

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

Preguntas frecuentes sobre la API de verificación por SMS

¿Qué es una API de verificación por SMS?

Una forma de comprar números y leer códigos desde tu propio programa en lugar del sitio web.

¿La API tiene un costo adicional?

No. Los números cuestan lo mismo que en el sitio web y se pagan con el mismo saldo.

¿Cuántas solicitudes puedo enviar?

Hasta 120 solicitudes por minuto por clave. Consultar cada 5 segundos queda muy por debajo de ese límite.

¿También se reembolsan los números de la API?

Sí, con la misma regla: si no llega código en 20 minutos, el precio vuelve a tu saldo.

¿Dónde creo la clave?

En tu cuenta, en Clave de API.

Números virtuales para otros servicios