Escolha um idioma

API para desenvolvedores

Verificação por SMS direto do seu código

Uma única chamada HTTPS dá ao seu bot ou plataforma um número real para WhatsApp, Telegram e muitos outros serviços. Leia o código por webhook ou long polling e pague só pelos números que recebem um.

  • 2.281serviços
  • 200países
  • Automáticoreembolso se o código não chegar

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

Feita para automação

Tudo o que sua integração precisa, com o mesmo estoque, a mesma contabilidade e os mesmos reembolsos do app.

  • Uma API REST limpa

    JSON previsível, compras idempotentes e motivos de erro claros para você agir.

  • Webhooks assinados

    Eventos assinados com HMAC para cada código e mudança de status, com novas tentativas por 24 horas.

  • Long polling

    Segure uma requisição por até 25 segundos e receba o código assim que ele chegar.

  • Compatível com sms-activate

    Aponte suas ferramentas para um novo endereço. As ações e respostas continuam as mesmas.

  • Chaves sob seu controle

    Chaves somente leitura ou de compra, listas de IPs permitidos, limites diários, expiração e rotação sem interrupção.

  • Reembolsos automáticos

    O código não chegou antes de o número expirar? A cobrança volta direto para o seu saldo.

  • Uso e registro de requisições

    Requisições, gastos e erros diários por chave, além de um registro filtrável dos últimos 7 dias.

  • Preços por volume

    Os mesmos preços do app, com descontos que crescem automaticamente com o seu volume mensal.

No ar em quatro passos

Seu primeiro número está a poucas chamadas de distância.

  1. Crie uma conta

    Cadastre-se com seu e-mail e confirme-o. O app e o site usam a mesma conta.

  2. Crie uma chave de API

    Escolha o acesso, limite-a aos seus servidores e copie o segredo uma vez.

  3. Compre um número

    Envie o serviço e o país via POST. Você recebe o número e o preço na hora.

  4. Receba o código

    Aguarde com long polling ou um webhook e depois conclua a ativação.

Preços que caem enquanto você cresce

A API cobra os mesmos preços do app. Seu desconto de atacado cresce com seus gastos dos últimos 30 dias em todos os canais.

  • Nunca mais caro que o mesmo número no app
  • Números sem código são reembolsados automaticamente
  • Sua faixa é atualizada minutos depois de ser atingida
  • Cobrado em USD do mesmo saldo do app

Desconto por gastos em 30 dias

As faixas de volume não estão ativas agora. Você paga os mesmos preços do app, e revendedores aprovados têm o desconto fixo deles.

Migração

Migre do sms-activate com uma linha

Nosso endpoint compatível fala o mesmo protocolo, então bots e painéis criados para sms-activate funcionam assim que você troca o endereço base e a chave.

O SMS-Activate encerrou em dezembro de 2025. Aponte suas ferramentas para a SmsGrab e elas continuam funcionando.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices e todas as outras ações padrão
  • Os IDs numéricos de ativação, códigos de serviço e IDs de país que você já usa
  • As mesmas chaves, limites, preços, reembolsos e webhooks da API REST
Referência de compatibilidade

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)
	}
}

Tempo real

Códigos enviados ao seu servidor

Assine os eventos que interessam e nós os entregamos no seu endpoint HTTPS com uma assinatura que você pode verificar.

  • Número comprado
  • Código recebido
  • Ativação concluída
  • Ativação cancelada
  • Ativação expirada
  • Cobrança reembolsada
  • Saldo acabando
  • Recarga criada
  • Recarga em confirmação
  • Recarga creditada
  • Recarga expirada
  • Recarga em análise
Guia de webhooks
600requisições por minuto por chave
60compras por minuto por chave
100números aguardando ao mesmo tempo
25segundos de long polling
  • Cada entrega é assinada com HMAC-SHA256 e um carimbo de data e hora
  • Só endpoints HTTPS públicos, verificados antes de cada entrega
  • Entregas de teste, histórico de 30 dias e reenvio com um clique

Perguntas de desenvolvedores

Quanto custa a API para desenvolvedores?

Não há assinatura. Cada número custa o mesmo que no app e é pago com o mesmo saldo. As faixas de volume reduzem esse preço conforme seus gastos de 30 dias crescem, e revendedores aprovados têm um desconto fixo. Números sem código são reembolsados automaticamente.

O que acontece se nenhum código chegar?

Um número fica ativo até o horário de expiração mostrado com ele, normalmente de 10 a 20 minutos. Se nenhum código chegar nesse tempo, ou se você cancelar enquanto ele ainda aguarda, a cobrança é reembolsada automaticamente no seu saldo.

Posso usar minha integração atual com sms-activate?

Sim. Troque o endereço base pelo nosso endpoint compatível e use sua chave da SmsGrab. As ações padrão, as respostas e os IDs numéricos continuam os mesmos.

Quais são os limites de taxa?

Por padrão, cada chave pode fazer 600 requisições e 60 compras por minuto, todas as chaves de uma conta juntas 3.000 requisições por minuto, e até 100 números podem aguardar um código ao mesmo tempo.

Como mantenho minha chave segura?

Guarde as chaves só nos seus servidores, dê a cada app a própria chave, limite-a aos endereços dos seus servidores e defina um limite diário de gastos. Se uma chave pode ter vazado, rotacione ou revogue-a na sua conta.

O app e a API usam o mesmo saldo?

Sim. A API usa o saldo da sua conta SmsGrab, e cada compra e reembolso aparece na sua carteira como qualquer outro.

Mais respostas na central de ajuda

Pronto para automatizar a verificação?

Crie uma chave na sua conta e faça sua primeira chamada em minutos.