JSON · HTTPS · chiave Bearer

Ricevi codici di verifica e invia SMS con un'unica API SMS

L'API di TODAY SMS è un'API per sviluppatori che unisce un'API di verifica SMS per ricevere codici su numeri monouso e un'API di invio SMS per inviare in 227 paesi, con una sola chiave API e un solo saldo. Ogni richiesta e risposta è in JSON, e prezzi e regole di rimborso sono gli stessi del sito.

Vedi la documentazione API Registrati e ottieni una chiave

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 richieste al minuto
Una chiave per ricevere e inviare
Non riusciti o non ricevuti rimborsati sul saldo
Ricarica con 12 metodi di criptovaluta

Cosa puoi fare con l'API SMS

API di verifica SMS

Scegli un'app e un paese, acquista un numero e interrogane lo stato per ottenere il codice di verifica. Se non arriva nessun SMS, l'intero importo torna sul saldo allo scadere del tempo.

API di invio SMS

Invia il tuo messaggio fino a 1.000 destinatari in una volta e ricevi un rapporto di consegna per ogni destinatario. Aggiungi un'ora programmata per inviarlo in quel momento.

API di prezzi e disponibilità

Ottieni tramite l'API paesi e prezzi per app, quantità di numeri e prezzo per SMS di ogni paese, e mostrali così come sono nel tuo servizio.

Un solo saldo

Ricezione e invio usano lo stesso saldo. Ricaricalo con USDT e controllalo in qualsiasi momento tramite l'API.

I metodi in sintesi

Documentazione completa

Metodo	Cosa fa
GET/balance	Ottieni il saldo
GET/apps	Elenco delle app
GET/prices?app=telegram	Paesi e prezzi di un'app
POST/numbers	Acquista un numero
GET/numbers/{id}	Stato del numero e SMS
POST/numbers/{id}/cancel	Annulla un numero
POST/numbers/{id}/finish	Chiudi un numero
GET/messages/prices	Prezzi SMS per paese
POST/messages	Invia SMS
GET/messages/{id}	Stato dell'invio e rapporti di consegna
POST/messages/{id}/cancel	Annulla un invio programmato

Che cos'è un'API SMS?

Un'API SMS è una connessione che permette al tuo software di ricevere o inviare SMS con richieste HTTP. Il codice fa ciò che una persona cliccherebbe su una schermata web, così le attività ripetitive come test di registrazione automatici, invio di codici di verifica e avvisi sugli ordini vanno avanti senza che nessuno debba muovere un dito.

L'API di TODAY SMS offre due cose insieme. Una è un'API di verifica SMS (API di attivazione SMS) per ricevere i codici di verifica delle app su numeri monouso, l'altra è un'API di invio SMS per inviare SMS ai cellulari di tutto il mondo. Entrambe usano lo stesso URL, la stessa chiave API e lo stesso saldo, quindi non servono registrazioni o ricariche separate.

Come si usa l'API di verifica SMS?

Bastano quattro passaggi. Scegli un codice app con GET /apps e vedi paesi e prezzi con GET /prices?app=CODE. Acquista un numero con POST /numbers per ottenere il numero e il suo id, poi chiama GET /numbers/{id} ogni pochi secondi per controllare se il codice è arrivato. Una volta ricevuto il codice, chiudi il numero con POST /numbers/{id}/finish.

Ogni numero attende gli SMS per 20 minuti, e gli SMS sullo stesso numero in quel tempo non costano nulla in più. Se non arriva nessun SMS, l'intero importo torna sul saldo allo scadere del tempo, e se non è arrivato nulla puoi annullare da solo con POST /numbers/{id}/cancel dopo 120 secondi dall'acquisto. Quando ti serve automatizzare la verifica delle app o un'API di numeri virtuali in grandi quantità, basta ripetere questo flusso.

Come si usa l'API di invio SMS?

Invia un elenco di destinatari (to) e il testo del messaggio (text) a POST /messages e ricevi l'id del messaggio, il numero di destinatari, il numero di parti e il costo totale. Inserisci i destinatari in formato internazionale con + e prefisso, fino a 1.000 per richiesta. Per programmare, inserisci un orario UTC in at.

Dopo l'invio, controlla il rapporto di consegna di ogni destinatario con GET /messages/{id}. Ci sono quattro stati: pending, sent, delivered e failed, e l'importo delle parti che finiscono in failed viene aggiunto a refunded e restituito sul saldo. Annulla un invio programmato non ancora partito con POST /messages/{id}/cancel.

Usa lo stesso metodo per inviare codici di verifica (OTP). Ogni codice conta come un SMS senza costi di verifica separati, e puoi ottenere il prezzo per SMS di ogni paese con GET /messages/prices per calcolare i costi.

Cosa guardare in un'API SMS conveniente?

Guarda il totale che paghi davvero, non solo il prezzo per SMS del listino. TODAY SMS non ha canone mensile e scala solo le parti che invii, e le parti non riuscite e i codici di verifica mai arrivati vengono rimborsati sul saldo.

Successivamente, guarda la gestione delle chiavi e i limiti. Ottieni una chiave API per account e puoi crearne una nuova in qualsiasi momento, che blocca immediatamente la vecchia chiave. Le richieste sono consentite fino a 300 al minuto, sufficienti per la maggior parte delle automazioni. Infine, guarda il pagamento. Puoi ricaricare con 12 metodi crittografici inclusi USDT, USDC e BTC senza carta, quindi puoi iniziare subito da qualsiasi paese.

Come ottengo una chiave API?

Crea un account e, non appena la prima ricarica viene accreditata, puoi creare una chiave nella pagina Chiave API. La chiave viene mostrata una sola volta alla creazione, quindi conservala in un posto sicuro. Inviala con ogni richiesta nell'intestazione Authorization: Bearer.

Se pensi che la chiave sia trapelata, crea una nuova chiave nella pagina Chiave API. La vecchia chiave smette subito di funzionare. Chiunque abbia la tua chiave può acquistare numeri o inviare SMS con il tuo saldo, quindi non inserirla mai nel codice del browser o in un repository pubblico.

Collega oggi l'API SMS

Per registrarti basta un token. Non appena la prima ricarica viene accreditata, crea una chiave API, incolla un esempio dalla documentazione e invia la tua prima richiesta.