Kies een taal

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)
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": []
}

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.

  1. Maak een account

    Registreer je met je e-mailadres en verifieer het. De app en de website gebruiken hetzelfde account.

  2. Maak een API-sleutel

    Kies de toegang, beperk hem tot je servers en kopieer het geheim één keer.

  3. Koop een nummer

    POST de dienst en het land. Je krijgt meteen het nummer en de prijs.

  4. 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

Korting per uitgaven in 30 dagen

Volumestaffels zijn nu niet actief. Je betaalt dezelfde prijzen als in de app, en goedgekeurde resellers krijgen hun vaste korting.

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
Compatibiliteitsreferentie

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
Webhook-handleiding
600verzoeken per minuut per sleutel
60aankopen per minuut per sleutel
100tegelijk wachtende nummers
25seconden long polling
  • 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.

Delen de app en de API één saldo?

Ja. De API gebruikt het saldo van je SmsGrab-account, en elke aankoop en terugbetaling verschijnt gewoon in je wallet.

Meer antwoorden vind je in het helpcentrum

Klaar om verificatie te automatiseren?

Maak een sleutel in je account en doe binnen een paar minuten je eerste aanroep.