Zum Inhalt springen
tomnumber

API für SMS-Verifizierung

Kaufen Sie Nummern und lesen Sie Codes aus Ihrer eigenen Software. Die API nutzt Ihr Guthaben, dieselben Preise und dieselbe 20-Minuten-Erstattungsregel wie die Website.

Den API-Schlüssel erstellen Sie in Ihrem Konto. Über die API gekaufte Nummern werden vom selben Guthaben zu denselben Preisen wie auf der Website abgebucht.

Konto erstellenAPI-Schlüssel

Ab $0.0018 pro Nummer

Die wichtigsten Fakten

Niedrigster Preis pro Nummer
$0.0018
Authentifizierung
API-Schlüssel
Format
JSON über HTTPS
Ratenlimit
120 Anfragen pro Minute
Rückerstattung
Wie auf der Website

REST und JSON

Sechs Anfragen decken Guthaben, Dienste, Preise, Nummernabruf, Status und Stornierung ab.

Ein Schlüssel aus Ihrem Konto

Erstellen Sie einen Schlüssel auf der Seite API-Schlüssel in Ihrem Konto und senden Sie ihn im Authorization-Header.

Dieselben Preise wie auf der Website

Nummernpreise und die 20-Minuten-Erstattungsregel sind dieselben wie auf der Website.

Welche Anfragen kann ich senden?

Die Pfade folgen auf die Basis-URL. Jede Anfrage braucht Ihren API-Schlüssel.

Welche Anfragen kann ich senden?
Methode und PfadFunktion
GET/balanceIhr Guthaben in USD
GET/servicesAlle Dienste mit niedrigstem Preis und Anzahl der Länder
GET/prices?service=telegramPreis einer Nummer in jedem Land für einen Dienst
POST/numbersNummer für einen Dienst und ein Land holen, der Preis wird vom Guthaben abgezogen
GET/numbers/{id}Status einer Nummer und alle bisher empfangenen Codes
POST/numbers/{id}/cancelVor dem Eintreffen eines Codes stornieren, der Preis geht zurück auf Ihr Guthaben

In welcher Reihenfolge rufe ich die API auf?

  1. 1

    Nummer holen POST /numbers mit service und country. Speichern Sie id und number.

  2. 2

    Nummer eingeben Geben Sie die Nummer bei dem Dienst ein, der den Code sendet.

  3. 3

    Code abfragen GET /numbers/{id} alle 5 Sekunden, bis die Liste codes nicht mehr leer ist.

  4. 4

    Abschließen Verwenden Sie den Code. Brauchen Sie die Nummer nicht mehr, bevor ein Code kommt, stornieren Sie sie.

Wie bekomme ich einen API-Schlüssel?

Melden Sie sich an und öffnen Sie in Ihrem Konto „API-Schlüssel“. Erstellen Sie einen Schlüssel und kopieren Sie ihn sofort. Er wird nur einmal angezeigt. Ein neuer Schlüssel deaktiviert den alten.

API-Schlüssel

Wie lautet die Basis-URL?

Senden Sie jede Anfrage an diese Adresse, mit dem Schlüssel im Authorization-Header (Bearer) oder im X-Api-Key-Header:

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

Anfragefelder

Anfragefelder
FeldVerwendet inWert
servicePOST /numbers, GET /pricesDienstname aus /services, z. B. telegram
countryPOST /numbersZweistelliger Ländercode, z. B. gb

Antwortfelder und Status

Antwortfelder und Status
WertBedeutung
waitingNummer ist offen, noch kein Code eingetroffen
receivedMindestens ein Code ist eingetroffen, bis expires_at können weitere kommen
refundedKein Code innerhalb von 20 Minuten, der Preis ging zurück auf Ihr Guthaben
canceledSie haben storniert, bevor ein Code kam, der Preis ging zurück auf Ihr Guthaben

Beispielantwort

{  "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" }  ]}

Fehlercodes

Fehlercodes
unauthorizedAPI-Schlüssel fehlt oder ist falsch
rate_limitedMehr als 120 Anfragen in einer Minute
bad_serviceUnbekannter Dienstname
bad_countryLand für diesen Dienst nicht verfügbar
low_balanceGuthaben ist niedriger als der Preis
unavailableGerade ist keine Nummer verfügbar. Es wurde nichts abgebucht
not_foundKeine Nummer mit dieser id in Ihrem Konto
cannot_cancelEin Code ist bereits eingetroffen oder die Nummer ist geschlossen

Codebeispiele

# 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"

FAQ zur API für SMS-Verifizierung

Was ist eine API für SMS-Verifizierung?

Eine Möglichkeit, Nummern zu kaufen und Codes aus Ihrem eigenen Programm statt über die Website abzurufen.

Kostet die API extra?

Nein. Nummern kosten dasselbe wie auf der Website und werden aus demselben Guthaben bezahlt.

Wie viele Anfragen kann ich senden?

Bis zu 120 Anfragen pro Minute und Schlüssel. Eine Abfrage alle 5 Sekunden liegt deutlich darunter.

Werden API-Nummern auch erstattet?

Ja, nach derselben Regel: Kommt innerhalb von 20 Minuten kein Code, geht der Preis zurück auf Ihr Guthaben.

Wo erstelle ich den Schlüssel?

In Ihrem Konto unter API-Schlüssel.

Virtuelle Nummern für andere Dienste