JSON · HTTPS · Clave Bearer

Recibe códigos de verificación y envía SMS con una sola API de SMS

La API de TODAY SMS es una API para desarrolladores que combina una API de verificación SMS para recibir códigos en números de un solo uso y una API de envío de SMS para enviar a 227 países, con una sola clave API y un solo saldo. Todas las solicitudes y respuestas son JSON, y los precios y las reglas de reembolso son los mismos que en el sitio web.

Ver la documentación API Regístrate y obtén una clave

today-sms.com/api/v1

$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}

$ curl -X POST https://today-sms.com/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":["+14155550100","+447700900123"],"text":"Your code is 482913"}'
{
  "id": "m_7Q2K9X",
  "status": "queued",
  "recipients": 2,
  "parts": 1,
  "encoding": "GSM-7",
  "cost": "0.0136"
}

$ curl https://today-sms.com/api/v1/messages/m_7Q2K9X \
  -H "Authorization: Bearer YOUR_API_KEY"

300 solicitudes por minuto
Una sola clave para recibir y enviar
Fallidos o no recibidos se reembolsan al saldo
Recarga con 12 métodos de cripto

Lo que puedes hacer con la API de SMS

API de verificación SMS

Elige una app y un país, compra un número y consulta su estado para obtener el código de verificación. Si no llega ningún SMS, el importe completo vuelve a tu saldo cuando se acaba el tiempo.

API de envío de SMS

Envía tu mensaje a hasta 1,000 destinatarios a la vez y recibe un informe de entrega por destinatario. Añade una hora programada para enviarlo en ese momento.

API de precios y disponibilidad

Obtén mediante la API los países y precios por app, la cantidad de números y el precio por SMS de cada país, y muéstralos tal cual en tu propio servicio.

Un solo saldo

La recepción y el envío usan el mismo saldo. Recárgalo con USDT y consúltalo cuando quieras mediante la API.

Métodos de un vistazo

Documentación completa

Método	Qué hace
GET/balance	Consultar saldo
GET/apps	Listar apps
GET/prices?app=telegram	Países y precios de una app
POST/numbers	Comprar un número
GET/numbers/{id}	Estado del número y SMS
POST/numbers/{id}/cancel	Cancelar un número
POST/numbers/{id}/finish	Finalizar un número
GET/messages/prices	Precios de SMS por país
POST/messages	Enviar SMS
GET/messages/{id}	Estado del envío e informes de entrega
POST/messages/{id}/cancel	Cancelar un envío programado

¿Qué es una API de SMS?

Una API de SMS es una conexión que permite a tu software recibir o enviar SMS con solicitudes HTTP. El código hace lo que una persona haría con clics en una pantalla web, así que las tareas repetitivas, como las pruebas de registro automatizadas, el envío de códigos de verificación y los avisos de pedidos, funcionan sin que nadie tenga que mover un dedo.

La API de TODAY SMS ofrece dos cosas a la vez. Una es una API de verificación SMS (API de activación SMS) para recibir códigos de verificación de apps en números de un solo uso, y la otra es una API de envío de SMS para enviar SMS a móviles de todo el mundo. Ambas usan la misma URL, la misma clave API y el mismo saldo, así que no hay registros ni recargas aparte.

¿Cómo uso la API de verificación SMS?

Son cuatro pasos. Elige un código de app con GET /apps y consulta países y precios con GET /prices?app=CODE. Compra un número con POST /numbers para obtener el número y su id, y luego llama a GET /numbers/{id} cada pocos segundos para comprobar si ha llegado el código. Cuando tengas el código, cierra el número con POST /numbers/{id}/finish.

Cada número espera 20 minutos los SMS, y los SMS al mismo número en ese tiempo no tienen coste extra. Si no llega ningún SMS, el importe completo vuelve a tu saldo cuando se acaba el tiempo, y si no ha llegado nada puedes cancelar tú mismo con POST /numbers/{id}/cancel a partir de 120 segundos después de la compra. Cuando necesites automatizar la verificación de apps o una API de números virtuales en volumen, solo tienes que repetir este flujo.

¿Cómo uso la API de envío de SMS?

Envía una lista de destinatarios (to) y el texto del mensaje (text) a POST /messages y recibes el id del mensaje, el número de destinatarios, el número de partes y el coste total. Introduce los destinatarios en formato internacional con + y el prefijo del país, hasta 1,000 por solicitud. Para programar, pon una hora UTC en at.

Después del envío, consulta el informe de entrega de cada destinatario con GET /messages/{id}. Hay cuatro estados: pending, sent, delivered y failed, y el importe de las partes que terminan como failed se suma a refunded y vuelve a tu saldo. Cancela un envío programado que aún no ha salido con POST /messages/{id}/cancel.

Usa el mismo método para enviar códigos de verificación (OTP). Cada código cuenta como un SMS sin tarifa de verificación aparte, y puedes obtener el precio por SMS de cada país con GET /messages/prices para calcular tus costes.

¿Qué debo buscar en una API de SMS económica?

Fíjate en el total que pagas realmente, no solo en el precio por SMS de la lista de precios. TODAY SMS no tiene cuota mensual y solo cobra las partes que envías, y las partes fallidas y los códigos de verificación que nunca llegaron se reembolsan a tu saldo.

A continuación, revisa la gestión de claves y límites. Obtienes una clave API por cuenta y puedes crear una nueva en cualquier momento, lo que bloquea la clave anterior de inmediato. Se permiten solicitudes de hasta 300 por minuto, suficiente para la mayoría de las automatizaciones. Finalmente, revisa el pago. Puedes recargar con 12 métodos cripto, incluidos USDT, USDC y BTC sin tarjeta, para que puedas comenzar de inmediato desde cualquier país.

¿Cómo obtengo una clave API?

Crea una cuenta y, en cuanto se acredite tu primera recarga, podrás crear una clave en la página de clave API. La clave se muestra una sola vez al crearla, así que guárdala en un lugar seguro. Envíala en cada solicitud en la cabecera Authorization: Bearer.

Si crees que tu clave se ha filtrado, crea una clave nueva en la página de clave API. La clave anterior deja de funcionar al instante. Cualquiera que tenga tu clave puede comprar números o enviar SMS con tu saldo, así que nunca la pongas en código del navegador ni en un repositorio público.

Conecta hoy la API de SMS

Para registrarte solo necesitas un token. En cuanto se acredite tu primera recarga, crea una clave API, pega un ejemplo de la documentación y envía tu primera solicitud.