JSON · HTTPS · Bearer-Schlüssel

Bestätigungscodes empfangen und SMS senden mit einer SMS-API

Die API von TODAY SMS ist eine Entwickler-API, die eine API zur SMS-Verifizierung für den Codeempfang auf Einmal-Nummern und eine API für den SMS-Versand in 227 Länder vereint, mit einem API-Schlüssel und einem Guthaben. Jede Anfrage und Antwort ist JSON, Preise und Erstattungsregeln sind dieselben wie auf der Website.

API-Doku ansehen Registrieren, Schlüssel holen

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 Anfragen pro Minute
Ein Schlüssel für Empfang und Versand
Fehlgeschlagenes oder nicht Empfangenes zurück aufs Guthaben
Mit 12 Krypto-Methoden aufladen

Was Sie mit der SMS-API tun können

API zur SMS-Verifizierung

App und Land wählen, eine Nummer kaufen und den Status abfragen, um den Bestätigungscode zu erhalten. Kommt keine SMS an, geht nach Ablauf der Zeit der volle Betrag zurück auf Ihr Guthaben.

API für den SMS-Versand

Senden Sie Ihre Nachricht an bis zu 1.000 Empfänger auf einmal und erhalten Sie einen Zustellbericht je Empfänger. Mit einer geplanten Zeit erfolgt der Versand genau dann.

API für Preise und Bestand

Rufen Sie Länder und Preise je App, Nummernbestand und den Preis pro SMS je Land über die API ab und zeigen Sie sie unverändert in Ihrem eigenen Dienst.

Ein Guthaben

Empfang und Versand nutzen dasselbe Guthaben. Laden Sie es mit USDT auf und prüfen Sie es jederzeit über die API.

Methoden auf einen Blick

Komplette Doku

Methode	Funktion
GET/balance	Guthaben abfragen
GET/apps	Apps auflisten
GET/prices?app=telegram	Länder und Preise einer App
POST/numbers	Nummer kaufen
GET/numbers/{id}	Nummernstatus und SMS
POST/numbers/{id}/cancel	Nummer stornieren
POST/numbers/{id}/finish	Nummer abschließen
GET/messages/prices	SMS-Preise nach Land
POST/messages	SMS senden
GET/messages/{id}	Versandstatus und Zustellberichte
POST/messages/{id}/cancel	Geplanten Versand stornieren

Was ist eine SMS-API?

Eine SMS-API ist eine Schnittstelle, über die Ihre Software mit HTTP-Anfragen SMS empfängt oder sendet. Code erledigt, was ein Mensch im Web anklicken würde, so laufen wiederkehrende Aufgaben wie automatisierte Registrierungstests, der Versand von Bestätigungscodes und Bestellhinweise ganz ohne Handarbeit.

Die API von TODAY SMS bietet zwei Dinge zusammen. Zum einen eine API zur SMS-Verifizierung (SMS-Aktivierungs-API), um Bestätigungscodes von Apps auf Einmal-Nummern zu empfangen, zum anderen eine API für den SMS-Versand an Mobiltelefone weltweit. Beide nutzen dieselbe URL, denselben API-Schlüssel und dasselbe Guthaben, eine extra Registrierung oder Aufladung ist nicht nötig.

Wie nutze ich die API zur SMS-Verifizierung?

Es sind vier Schritte. Wählen Sie mit GET /apps einen App-Code und sehen Sie mit GET /prices?app=CODE Länder und Preise. Kaufen Sie mit POST /numbers eine Nummer, um Nummer und id zu erhalten, und rufen Sie dann alle paar Sekunden GET /numbers/{id} auf, um zu prüfen, ob der Code angekommen ist. Haben Sie den Code, schließen Sie die Nummer mit POST /numbers/{id}/finish.

Jede Nummer wartet 20 Minuten auf SMS, und SMS an dieselbe Nummer in dieser Zeit kosten nichts extra. Kommt keine SMS an, geht nach Ablauf der Zeit der volle Betrag zurück auf Ihr Guthaben, und ist nichts angekommen, können Sie ab 120 Sekunden nach dem Kauf selbst mit POST /numbers/{id}/cancel stornieren. Brauchen Sie Automatisierung für App-Verifizierungen oder eine API für viele virtuelle Nummern, wiederholen Sie einfach diesen Ablauf.

Wie nutze ich die API für den SMS-Versand?

Senden Sie eine Empfängerliste (to) und den Nachrichtentext (text) an POST /messages, und Sie erhalten Nachrichten-id, Anzahl der Empfänger, Anzahl der Teile und Gesamtkosten zurück. Geben Sie Empfänger im internationalen Format mit + und Ländervorwahl ein, bis zu 1.000 pro Anfrage. Zum Planen setzen Sie eine UTC-Zeit in at.

Nach dem Senden prüfen Sie mit GET /messages/{id} den Zustellbericht je Empfänger. Es gibt vier Status: pending, sent, delivered und failed, und der Betrag für Teile mit dem Ergebnis failed wird zu refunded addiert und Ihrem Guthaben erstattet. Einen geplanten Versand, der noch nicht erfolgt ist, stornieren Sie mit POST /messages/{id}/cancel.

Mit derselben Methode senden Sie auch Bestätigungscodes (OTP). Jeder Code zählt als eine SMS ohne extra Verifizierungsgebühr, und den Preis pro SMS je Land erhalten Sie mit GET /messages/prices, um Ihre Kosten zu berechnen.

Worauf sollte ich bei einer günstigen SMS-API achten?

Achten Sie auf den Betrag, den Sie tatsächlich zahlen, nicht nur auf den Preis pro SMS in der Preisliste. TODAY SMS hat keine Monatsgebühr und bucht nur die gesendeten Teile ab, und fehlgeschlagene Teile sowie nie angekommene Bestätigungscodes werden Ihrem Guthaben erstattet.

Als nächstes sehen Sie sich die Schlüsselverwaltung und Limits an. Sie erhalten einen API-Schlüssel pro Konto und können jederzeit einen neuen erstellen, wodurch der alte Schlüssel sofort gesperrt wird. Anfragen sind bis zu 300 pro Minute erlaubt, was für die meisten Automatisierungen ausreicht. Schließlich sehen Sie sich die Zahlung an. Sie können mit 12 Krypto-Methoden wie USDT, USDC und BTC ohne Karte aufladen, sodass Sie sofort aus jedem Land starten können.

Wie erhalte ich einen API-Schlüssel?

Erstellen Sie ein Konto, und sobald Ihre erste Aufladung gutgeschrieben ist, erstellen Sie auf der Seite API-Schlüssel einen Schlüssel. Der Schlüssel wird beim Erstellen nur einmal angezeigt, bewahren Sie ihn also sicher auf. Senden Sie ihn bei jeder Anfrage im Header Authorization: Bearer.

Vermuten Sie, dass Ihr Schlüssel bekannt geworden ist, erstellen Sie auf der Seite API-Schlüssel einen neuen. Der alte Schlüssel funktioniert dann sofort nicht mehr. Wer Ihren Schlüssel hat, kann mit Ihrem Guthaben Nummern kaufen oder SMS senden, legen Sie ihn also nie in Browser-Code oder ein öffentliches Repository.

Binden Sie die SMS-API noch heute an

Für die Registrierung genügt ein Token. Sobald Ihre erste Aufladung gutgeschrieben ist, erstellen Sie einen API-Schlüssel, fügen ein Beispiel aus der Doku ein und senden Ihre erste Anfrage.