Ontwikkelaars-API
Sms-verificatie vanuit je eigen code
Eén HTTPS-aanroep geeft je bot of platform een echt nummer voor WhatsApp, Telegram en nog veel meer diensten. Lees de code via een webhook of long polling en betaal alleen voor nummers die er een krijgen.
- 2.279diensten
- 200landen
- Automatischterugbetaald als er geen code komt
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)
{
"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": []
}
Gebouwd voor automatisering
Alles wat je integratie nodig heeft, met dezelfde voorraad, boekhouding en terugbetalingen als de app.
-
Een heldere REST-API
Voorspelbare JSON, idempotente aankopen en duidelijke foutredenen waarop je kunt reageren.
-
Ondertekende webhooks
Met HMAC ondertekende gebeurtenissen voor elke code en statuswijziging, met herhalingen tot 24 uur.
-
Long polling
Houd een verzoek tot 25 seconden open en krijg de code zodra hij binnenkomt.
-
Compatibel met sms-activate
Wijs je bestaande tools naar één nieuw adres. Acties en antwoorden blijven hetzelfde.
-
Sleutels onder jouw controle
Lees- of koopsleutels, IP-toelatingslijsten, daglimieten, vervaldatum en vervangen zonder onderbreking.
-
Automatische terugbetaling
Geen code voordat het nummer verloopt? Het bedrag gaat direct terug naar je saldo.
-
Gebruik en verzoeklogboek
Dagelijkse verzoeken, uitgaven en fouten per sleutel, plus een filterbaar logboek van de laatste 7 dagen.
-
Volumeprijzen
Dezelfde prijzen als in de app, met kortingen die automatisch meegroeien met je maandvolume.
Live in vier stappen
Je eerste nummer is maar een paar aanroepen verwijderd.
-
Maak een account
Registreer je met je e-mailadres en verifieer het. De app en de website gebruiken hetzelfde account.
-
Maak een API-sleutel
Kies de toegang, beperk hem tot je servers en kopieer het geheim één keer.
-
Koop een nummer
POST de dienst en het land. Je krijgt meteen het nummer en de prijs.
-
Ontvang de code
Wacht met long polling of een webhook en rond daarna de activering af.
Prijzen die dalen terwijl je groeit
De API rekent dezelfde prijzen als de app. Je groothandelkorting groeit mee met je uitgaven van de afgelopen 30 dagen via alle kanalen.
- Nooit duurder dan hetzelfde nummer in de app
- Nummers zonder code worden automatisch terugbetaald
- Je niveau wordt binnen enkele minuten na het bereiken bijgewerkt
- Afgerekend in USD vanaf hetzelfde saldo als de app
Overstappen
Stap over van sms-activate met één regel
Ons compatibele endpoint spreekt hetzelfde protocol, dus bots en panelen die voor sms-activate zijn gebouwd, werken zodra je het basisadres en de sleutel wijzigt.
SMS-Activate is in december 2025 gestopt. Richt je tools op SmsGrab en ze blijven werken.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices en alle andere standaardacties
- De numerieke activerings-ID’s, dienstcodes en land-ID’s die je al gebruikt
- Dezelfde sleutels, limieten, prijzen, terugbetalingen en webhooks als de REST-API
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)
}
}
Realtime
Codes direct naar je server
Abonneer je op de gebeurtenissen die je belangrijk vindt en we leveren ze aan je HTTPS-endpoint met een handtekening die je kunt controleren.
- Nummer gekocht
- Code ontvangen
- Activering afgerond
- Activering geannuleerd
- Activering verlopen
- Bedrag terugbetaald
- Saldo raakt op
- Opwaardering gemaakt
- Opwaardering wordt bevestigd
- Opwaardering bijgeschreven
- Opwaardering verlopen
- Opwaardering in controle
- Elke levering is ondertekend met HMAC-SHA256 en een tijdstempel
- Alleen openbare HTTPS-endpoints, gecontroleerd voor elke levering
- Testleveringen, 30 dagen geschiedenis en opnieuw afleveren met één klik
Vragen van ontwikkelaars
Wat kost de ontwikkelaars-API?
Er is geen abonnement. Elk nummer kost hetzelfde als in de app en wordt betaald met hetzelfde saldo. Volumestaffels verlagen die prijs naarmate je uitgaven over 30 dagen groeien, en goedgekeurde resellers krijgen een vaste korting. Nummers zonder code worden automatisch terugbetaald.
Wat gebeurt er als er geen code komt?
Een nummer is geldig tot de vervaltijd die erbij staat, meestal 10 tot 20 minuten. Komt er in die tijd geen code, of annuleer je terwijl het nog wacht, dan wordt het bedrag automatisch teruggezet op je saldo.
Kan ik mijn bestaande sms-activate-integratie gebruiken?
Ja. Vervang het basisadres door ons compatibele endpoint en gebruik je SmsGrab-sleutel. Standaardacties, antwoorden en numerieke ID’s blijven hetzelfde.
Welke snelheidslimieten gelden er?
Standaard kan elke sleutel 600 verzoeken en 60 aankopen per minuut doen, alle sleutels van een account samen 3.000 verzoeken per minuut, en maximaal 100 nummers kunnen tegelijk op een code wachten.
Hoe houd ik mijn sleutel veilig?
Bewaar sleutels alleen op je servers, geef elke app een eigen sleutel, beperk hem tot je serveradressen en stel een daglimiet in. Is een sleutel mogelijk uitgelekt, vervang of trek hem dan in via je account.
Meer antwoorden vind je in het helpcentrum