Sprache auswählen

Entwickler-API

SMS-Verifizierung direkt aus deinem Code

Ein HTTPS-Aufruf gibt deinem Bot oder deiner Plattform eine echte Nummer für WhatsApp, Telegram und viele weitere Dienste. Lies den Code per Webhook oder Long Polling und zahle nur für Nummern, die einen Code erhalten.

  • 2.281Dienste
  • 200Länder
  • Automatischerstattet, wenn kein Code ankommt

curl

curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
  -H "Authorization: Bearer $SMSGRAB_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"indonesia"}'

Python

activation = requests.post(
    "https://smsgrab.com/api/dev/v1/activations",
    headers={"Authorization": f"Bearer {key}", "Idempotency-Key": str(uuid.uuid4())},
    json={"service": "whatsapp", "country": "indonesia"},
    timeout=30,
).json()

Node.js

const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${key}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());

PHP

$activation = json_decode((string) $client->post('activations', [
    'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
    'headers' => ['Idempotency-Key' => bin2hex(random_bytes(16))],
])->getBody(), true);

Go

order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation)
201 Created
{
  "id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
  "compat_id": 100000123,
  "status": "WAITING_SMS",
  "service_id": "whatsapp",
  "country_id": "indonesia",
  "phone_number": "+6281234567890",
  "price_minor": 17,
  "currency": "USD",
  "expires_at": "2026-09-27T10:25:00.000Z",
  "sms": []
}

Gebaut für Automatisierung

Alles, was deine Integration braucht – mit demselben Bestand, derselben Buchhaltung und denselben Erstattungen wie die App.

  • Saubere REST-API

    Vorhersehbares JSON, idempotente Käufe und klare Fehlergründe, auf die du reagieren kannst.

  • Signierte Webhooks

    HMAC-signierte Ereignisse für jeden Code und jede Statusänderung, mit Wiederholungen über 24 Stunden.

  • Long Polling

    Halte eine Anfrage bis zu 25 Sekunden offen und erhalte den Code, sobald er ankommt.

  • sms-activate-kompatibel

    Richte deine bestehenden Tools auf eine neue Adresse. Aktionen und Antworten bleiben gleich.

  • Schlüssel unter deiner Kontrolle

    Lese- oder Kaufschlüssel, IP-Freigabelisten, Tageslimits, Ablaufdatum und Rotation ohne Ausfallzeit.

  • Automatische Erstattungen

    Kein Code, bevor die Nummer abläuft? Der Betrag geht direkt zurück auf dein Guthaben.

  • Nutzung und Anfrageprotokoll

    Tägliche Anfragen, Ausgaben und Fehler pro Schlüssel, dazu ein filterbares Protokoll der letzten 7 Tage.

  • Mengenpreise

    Dieselben Preise wie in der App, mit Rabatten, die automatisch mit deinem Monatsvolumen wachsen.

In vier Schritten live

Deine erste Nummer ist nur ein paar Aufrufe entfernt.

  1. Konto erstellen

    Registriere dich mit deiner E-Mail-Adresse und bestätige sie. App und Website teilen dasselbe Konto.

  2. API-Schlüssel erstellen

    Wähle den Zugriff, beschränke ihn auf deine Server und kopiere das Secret einmal.

  3. Nummer kaufen

    Sende Dienst und Land per POST. Du bekommst Nummer und Preis sofort.

  4. Code empfangen

    Warte per Long Polling oder Webhook und schließe die Aktivierung dann ab.

Preise, die mit dir sinken

Die API berechnet dieselben Preise wie die App. Dein Großhandelsrabatt wächst mit deinen Ausgaben der letzten 30 Tage auf allen Kanälen.

  • Nie mehr als der Preis derselben Nummer in der App
  • Nummern ohne Code werden automatisch erstattet
  • Deine Stufe wird Minuten nach Erreichen aktualisiert
  • Abgerechnet in USD vom selben Guthaben wie die App

Rabatt nach Ausgaben in 30 Tagen

Mengenstaffeln sind gerade nicht aktiv. Du zahlst dieselben Preise wie in der App, und freigegebene Wiederverkäufer erhalten ihren festen Rabatt.

Umstieg

Wechsle von sms-activate mit einer Zeile

Unser kompatibler Endpunkt spricht dasselbe Protokoll. Bots und Panels für sms-activate funktionieren, sobald du Basisadresse und Schlüssel änderst.

SMS-Activate wurde im Dezember 2025 eingestellt. Richte deine Tools auf SmsGrab aus und sie laufen weiter.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices und alle weiteren Standardaktionen
  • Numerische Aktivierungs-IDs, Dienstcodes und Länder-IDs, die du schon nutzt
  • Dieselben Schlüssel, Limits, Preise, Erstattungen und Webhooks wie bei der REST-API
Kompatibilitätsreferenz

curl

BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"

curl -s -w '\n' "$BASE&action=getBalance"
curl -s -w '\n' "$BASE&action=getNumber&service=tg&country=6&maxPrice=0.30"
curl -s -w '\n' "$BASE&action=getStatus&id=100000123"
curl -s -w '\n' "$BASE&action=setStatus&id=100000123&status=6"

Python

import os
import time

import requests

BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]


def action(name: str, **params) -> str:
    response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
    response.raise_for_status()
    return response.text


print(action("getBalance"))
answer = action("getNumber", service="tg", country=6, maxPrice="0.30")
if not answer.startswith("ACCESS_NUMBER:"):
    raise SystemExit(answer)
_, activation_id, number = answer.split(":")
print("Number:", number)

while True:
    status = action("getStatus", id=activation_id)
    if status.startswith("STATUS_OK:"):
        print("Code:", status.split(":", 1)[1])
        action("setStatus", id=activation_id, status=6)
        break
    if status == "STATUS_CANCEL":
        print("Cancelled or expired, the charge was refunded")
        break
    time.sleep(5)

Node.js

const BASE = 'https://smsgrab.com/api/stubs/handler_api.php';

async function action(name, params = {}) {
  const url = new URL(BASE);
  url.search = new URLSearchParams({ api_key: process.env.SMSGRAB_API_KEY, action: name, ...params }).toString();
  const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }
  return response.text();
}

console.log(await action('getBalance'));
const answer = await action('getNumber', { service: 'tg', country: '6', maxPrice: '0.30' });
if (!answer.startsWith('ACCESS_NUMBER:')) {
  throw new Error(answer);
}
const [, id, number] = answer.split(':');
console.log('Number:', number);

for (;;) {
  const status = await action('getStatus', { id });
  if (status.startsWith('STATUS_OK:')) {
    console.log('Code:', status.slice('STATUS_OK:'.length));
    await action('setStatus', { id, status: '6' });
    break;
  }
  if (status === 'STATUS_CANCEL') {
    console.log('Cancelled or expired, the charge was refunded');
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 5000));
}

PHP

<?php

function smsgrab(string $action, array $params = []): string
{
    $query = http_build_query(['api_key' => getenv('SMSGRAB_API_KEY'), 'action' => $action] + $params);
    $answer = file_get_contents('https://smsgrab.com/api/stubs/handler_api.php?'.$query, false, stream_context_create(['http' => ['timeout' => 30]]));
    if ($answer === false) {
        throw new RuntimeException('The request failed');
    }

    return $answer;
}

echo smsgrab('getBalance').PHP_EOL;
$answer = smsgrab('getNumber', ['service' => 'tg', 'country' => 6, 'maxPrice' => '0.30']);
if (! str_starts_with($answer, 'ACCESS_NUMBER:')) {
    exit($answer.PHP_EOL);
}
[, $id, $number] = explode(':', $answer);
echo 'Number: '.$number.PHP_EOL;

while (true) {
    $status = smsgrab('getStatus', ['id' => $id]);
    if (str_starts_with($status, 'STATUS_OK:')) {
        echo 'Code: '.substr($status, strlen('STATUS_OK:')).PHP_EOL;
        smsgrab('setStatus', ['id' => $id, 'status' => 6]);
        break;
    }
    if ($status === 'STATUS_CANCEL') {
        echo 'Cancelled or expired, the charge was refunded'.PHP_EOL;
        break;
    }
    sleep(5);
}

Go

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
	"os"
	"strings"
	"time"
)

const base = "https://smsgrab.com/api/stubs/handler_api.php"

var client = &http.Client{Timeout: 30 * time.Second}

func action(name string, params url.Values) (string, error) {
	query := url.Values{"api_key": {os.Getenv("SMSGRAB_API_KEY")}, "action": {name}}
	for key, values := range params {
		query[key] = values
	}
	response, err := client.Get(base + "?" + query.Encode())
	if err != nil {
		return "", err
	}
	defer response.Body.Close()
	body, err := io.ReadAll(io.LimitReader(response.Body, 1<<20))
	if err != nil {
		return "", err
	}
	if response.StatusCode != http.StatusOK {
		return "", fmt.Errorf("http %d: %s", response.StatusCode, body)
	}
	return string(body), nil
}

func main() {
	answer, err := action("getNumber", url.Values{"service": {"tg"}, "country": {"6"}, "maxPrice": {"0.30"}})
	if err != nil {
		panic(err)
	}
	if !strings.HasPrefix(answer, "ACCESS_NUMBER:") {
		fmt.Println(answer)
		return
	}
	parts := strings.Split(answer, ":")
	id := parts[1]
	fmt.Println("Number:", parts[2])
	for {
		status, err := action("getStatus", url.Values{"id": {id}})
		if err != nil {
			panic(err)
		}
		if code, ok := strings.CutPrefix(status, "STATUS_OK:"); ok {
			fmt.Println("Code:", code)
			if _, err := action("setStatus", url.Values{"id": {id}, "status": {"6"}}); err != nil {
				panic(err)
			}
			return
		}
		if status == "STATUS_CANCEL" {
			fmt.Println("Cancelled or expired, the charge was refunded")
			return
		}
		time.Sleep(5 * time.Second)
	}
}

Echtzeit

Codes direkt auf deinen Server

Abonniere die Ereignisse, die dich interessieren, und wir liefern sie mit einer prüfbaren Signatur an deinen HTTPS-Endpunkt.

  • Nummer gekauft
  • Code empfangen
  • Aktivierung abgeschlossen
  • Aktivierung storniert
  • Aktivierung abgelaufen
  • Betrag erstattet
  • Guthaben wird knapp
  • Aufladung erstellt
  • Aufladung wird bestätigt
  • Aufladung gutgeschrieben
  • Aufladung abgelaufen
  • Aufladung in Prüfung
Webhook-Anleitung
600Anfragen pro Minute und Schlüssel
60Käufe pro Minute und Schlüssel
100gleichzeitig wartende Nummern
25Sekunden Long Polling
  • Jede Zustellung ist mit HMAC-SHA256 und Zeitstempel signiert
  • Nur öffentliche HTTPS-Endpunkte, geprüft vor jeder Zustellung
  • Testzustellungen, 30 Tage Verlauf und erneute Zustellung per Klick

Fragen von Entwicklern

Was kostet die Entwickler-API?

Es gibt kein Abo. Jede Nummer kostet dasselbe wie in der App und wird aus demselben Guthaben bezahlt. Mengenstaffeln senken diesen Preis, wenn deine Ausgaben der letzten 30 Tage wachsen, und freigegebene Wiederverkäufer erhalten einen festen Rabatt. Nummern ohne Code werden automatisch erstattet.

Was passiert, wenn kein Code ankommt?

Eine Nummer ist bis zu der angezeigten Ablaufzeit gültig, meist 10 bis 20 Minuten. Kommt in dieser Zeit kein Code an oder stornierst du, solange sie noch wartet, wird der Betrag automatisch auf dein Guthaben erstattet.

Kann ich meine bestehende sms-activate-Integration nutzen?

Ja. Ersetze die Basisadresse durch unseren kompatiblen Endpunkt und verwende deinen SmsGrab-Schlüssel. Standardaktionen, Antworten und numerische IDs bleiben gleich.

Welche Ratenlimits gelten?

Standardmäßig kann jeder Schlüssel 600 Anfragen und 60 Käufe pro Minute ausführen, alle Schlüssel eines Kontos zusammen 3.000 Anfragen pro Minute, und bis zu 100 Nummern können gleichzeitig auf einen Code warten.

Wie halte ich meinen Schlüssel sicher?

Bewahre Schlüssel nur auf deinen Servern auf, gib jeder App einen eigenen Schlüssel, beschränke ihn auf deine Serveradressen und setze ein Tageslimit. Wurde ein Schlüssel womöglich öffentlich, rotiere oder widerrufe ihn in deinem Konto.

Teilen sich App und API ein Guthaben?

Ja. Die API nutzt das Guthaben deines SmsGrab-Kontos, und jeder Kauf und jede Erstattung erscheint wie gewohnt in deiner Wallet.

Weitere Antworten findest du im Hilfe-Center

Bereit, Verifizierungen zu automatisieren?

Erstelle einen Schlüssel in deinem Konto und mach in wenigen Minuten deinen ersten Aufruf.