TODAY SMS

JSON · HTTPS · chave Bearer

Receba códigos de verificação e envie SMS com uma só API de SMS

A API do TODAY SMS é uma API para desenvolvedores que reúne uma API de verificação por SMS, para receber códigos em números temporários, e uma API de envio de SMS, para enviar para 227 países, com uma só chave de API e um só saldo. Todas as requisições e respostas são JSON, e os preços e as regras de reembolso são os mesmos do site.

Ver documentação da APICrie sua conta e obtenha uma chave
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" }
  ]
}
  • 300 requisições por minuto
  • Uma só chave para receber e enviar
  • Falhas e não recebidos reembolsados no saldo
  • Recarregue com 12 métodos de criptomoedas

O que você pode fazer com a API de SMS

API de verificação por SMS

Escolha um app e um país, compre um número e consulte o status dele para obter o código de verificação. Se nenhum SMS chegar, o valor total volta para o seu saldo quando o prazo acaba.

API de envio de SMS

Envie sua mensagem para até 1.000 destinatários de uma vez e receba um relatório de entrega por destinatário. Adicione um horário agendado para enviar nesse momento.

API de preços e estoque

Obtenha pela API os países e preços por app, a quantidade de números e o preço por SMS de cada país, e mostre esses dados como estão no seu próprio serviço.

Um só saldo

Receber e enviar usam o mesmo saldo. Recarregue com USDT e consulte o saldo a qualquer momento pela API.

Métodos em um relance

MétodoO que faz
GET/balanceConsultar saldo
GET/appsListar apps
GET/prices?app=telegramPaíses e preços de um app
POST/numbersComprar um número
GET/numbers/{id}Status do número e SMS
POST/numbers/{id}/cancelCancelar um número
POST/numbers/{id}/finishConcluir um número
GET/messages/pricesPreços de SMS por país
POST/messagesEnviar SMS
GET/messages/{id}Status do envio e relatórios de entrega
POST/messages/{id}/cancelCancelar um envio agendado

O que é uma API de SMS?

Uma API de SMS é uma conexão que permite ao seu software receber ou enviar SMS com requisições HTTP. O código faz o que uma pessoa clicaria em uma tela da web, então tarefas repetidas, como testes automatizados de cadastro, envio de códigos de verificação e avisos de pedidos, funcionam sem ninguém mexer um dedo.

A API do TODAY SMS oferece duas coisas juntas. Uma é a API de verificação por SMS (API de ativação por SMS), para receber códigos de verificação de apps em números temporários, e a outra é a API de envio de SMS, para enviar SMS para celulares do mundo todo. As duas usam a mesma URL, a mesma chave de API e o mesmo saldo, então não há cadastro nem recarga separados.

Como usar a API de verificação por SMS?

São quatro passos. Escolha um código de app com GET /apps e veja os países e preços com GET /prices?app=CODE. Compre um número com POST /numbers para obter o número e o id dele, depois chame GET /numbers/{id} a cada poucos segundos para ver se o código chegou. Depois de receber o código, encerre o número com POST /numbers/{id}/finish.

Cada número aguarda SMS por 20 minutos, e os SMS para o mesmo número nesse período não têm custo extra. Se nenhum SMS chegar, o valor total volta para o seu saldo quando o prazo acaba e, se nada tiver chegado, você mesmo pode cancelar com POST /numbers/{id}/cancel a partir de 120 segundos depois da compra. Quando precisar de automação de verificação de apps ou de uma API de números virtuais em grande volume, basta repetir esse fluxo.

Como usar a API de envio de SMS?

Envie uma lista de destinatários (to) e o texto da mensagem (text) para POST /messages e você recebe de volta o id da mensagem, o número de destinatários, o número de partes e o custo total. Informe os destinatários no formato internacional com + e o código do país, até 1.000 por requisição. Para agendar, coloque um horário em UTC em at.

Depois do envio, confira o relatório de entrega de cada destinatário com GET /messages/{id}. Há quatro status: pending, sent, delivered e failed, e o valor das partes que terminam como failed é somado em refunded e devolvido ao seu saldo. Cancele um envio agendado que ainda não saiu com POST /messages/{id}/cancel.

Use o mesmo método para enviar códigos de verificação (OTP). Cada código conta como um SMS, sem taxa de verificação separada, e você pode obter o preço por SMS de cada país com GET /messages/prices para calcular seus custos.

O que observar em uma API de SMS barata?

Olhe o total que você realmente paga, e não só o preço por SMS da tabela. O TODAY SMS não tem mensalidade e desconta apenas as partes que você envia, e as partes com falha e os códigos de verificação que nunca chegaram são reembolsados no seu saldo.

Em seguida, veja a gestão de chaves e limites. Você obtém uma chave API por conta e pode criar uma nova a qualquer momento, o que bloqueia a chave antiga imediatamente. São permitidas até 300 solicitações por minuto, suficientes para a maioria das automações. Por fim, veja o pagamento. Você pode recarregar com 12 métodos de criptomoedas, incluindo USDT, USDC e BTC sem cartão, para que você possa começar imediatamente de qualquer país.

Como obtenho uma chave de API?

Crie uma conta e, assim que a primeira recarga for creditada, você pode criar uma chave na página de chave de API. A chave aparece só uma vez, quando é criada, então guarde-a em um lugar seguro. Envie-a em toda requisição no cabeçalho Authorization: Bearer.

Se você acha que sua chave vazou, crie uma nova chave na página de chave de API. A chave antiga para de funcionar na hora. Qualquer pessoa com a sua chave pode comprar números ou enviar SMS com o seu saldo, então nunca a coloque em código de navegador nem em um repositório público.

Conecte a API de SMS hoje

O cadastro precisa de apenas um token. Assim que a primeira recarga for creditada, crie uma chave de API, cole um exemplo da documentação e envie sua primeira requisição.

Ver documentação da APICrie sua conta e obtenha uma chave