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)
{
"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.
-
Crie uma conta
Cadastre-se com seu e-mail e confirme-o. O app e o site usam a mesma conta.
-
Crie uma chave de API
Escolha o acesso, limite-a aos seus servidores e copie o segredo uma vez.
-
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.
-
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
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
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
- 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.
Mais respostas na central de ajuda