API para desarrolladores
Verificación por SMS desde tu propio código
Una sola llamada HTTPS da a tu bot o plataforma un número real para WhatsApp, Telegram y muchos servicios más. Lee el código por webhook o long polling y paga solo por los números que lo reciben.
- 2.279servicios
- 200países
- Autoreembolso si no llega el código
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": []
}
Hecha para automatizar
Todo lo que tu integración necesita, con el mismo stock, la misma contabilidad y los mismos reembolsos que la app.
-
Una API REST limpia
JSON predecible, compras idempotentes y motivos de error claros con los que actuar.
-
Webhooks firmados
Eventos firmados con HMAC para cada código y cambio de estado, con reintentos durante 24 horas.
-
Long polling
Mantén una solicitud hasta 25 segundos y recibe el código en cuanto llega.
-
Compatible con sms-activate
Apunta tus herramientas actuales a una nueva dirección. Las acciones y respuestas no cambian.
-
Claves bajo tu control
Claves de solo lectura o de compra, listas de IP permitidas, límites diarios, caducidad y rotación sin cortes.
-
Reembolsos automáticos
¿No llegó el código antes de que caducara el número? El cargo vuelve directamente a tu saldo.
-
Uso y registro de solicitudes
Solicitudes, gasto y errores diarios por clave, además de un registro filtrable de los últimos 7 días.
-
Precios por volumen
Los mismos precios que la app, con descuentos que crecen automáticamente con tu volumen mensual.
En marcha en cuatro pasos
Tu primer número está a unas pocas llamadas.
-
Crea una cuenta
Regístrate con tu correo y verifícalo. La app y la web comparten la misma cuenta.
-
Crea una clave de API
Elige su acceso, limítala a tus servidores y copia el secreto una vez.
-
Compra un número
Envía el servicio y el país por POST. Recibes el número y su precio al instante.
-
Recibe el código
Espera con long polling o un webhook y luego finaliza la activación.
Precios que bajan mientras creces
La API cobra los mismos precios que la app. Tu descuento mayorista crece con tu gasto de los últimos 30 días en todos los canales.
- Nunca más caro que el mismo número en la app
- Los números sin código se reembolsan automáticamente
- Tu nivel se actualiza minutos después de alcanzarlo
- Se cobra en USD del mismo saldo que la app
Migración
Cambia desde sms-activate con una línea
Nuestro endpoint compatible habla el mismo protocolo: los bots y paneles creados para sms-activate funcionan en cuanto cambias la dirección base y la clave.
SMS-Activate cerró en diciembre de 2025. Apunta tus herramientas a SmsGrab y seguirán funcionando.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices y todas las demás acciones estándar
- Los ID numéricos de activación, códigos de servicio e ID de país que ya usas
- Las mismas claves, límites, precios, reembolsos y webhooks que la 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)
}
}
Tiempo real
Códigos enviados a tu servidor
Suscríbete a los eventos que te interesan y los entregamos en tu endpoint HTTPS con una firma que puedes comprobar.
- Número comprado
- Código recibido
- Activación completada
- Activación cancelada
- Activación caducada
- Cargo reembolsado
- Saldo bajo
- Recarga creada
- Recarga confirmándose
- Recarga abonada
- Recarga caducada
- Recarga en revisión
- Cada entrega va firmada con HMAC-SHA256 y una marca de tiempo
- Solo endpoints HTTPS públicos, comprobados antes de cada entrega
- Entregas de prueba, historial de 30 días y reenvío con un clic
Preguntas de desarrolladores
¿Cuánto cuesta la API para desarrolladores?
No hay suscripción. Cada número cuesta lo mismo que en la app y se paga con el mismo saldo. Los niveles por volumen bajan ese precio a medida que crece tu gasto de 30 días, y los revendedores aprobados tienen un descuento fijo. Los números sin código se reembolsan automáticamente.
¿Qué pasa si no llega ningún código?
Un número sigue activo hasta la hora de caducidad que se muestra con él, normalmente entre 10 y 20 minutos. Si no llega ningún código en ese tiempo, o lo cancelas mientras sigue esperando, el cargo se reembolsa automáticamente a tu saldo.
¿Puedo usar mi integración actual de sms-activate?
Sí. Cambia la dirección base por nuestro endpoint compatible y usa tu clave de SmsGrab. Las acciones estándar, las respuestas y los ID numéricos no cambian.
¿Cuáles son los límites de frecuencia?
Por defecto, cada clave puede hacer 600 solicitudes y 60 compras por minuto, todas las claves de una cuenta juntas 3.000 solicitudes por minuto, y hasta 100 números pueden esperar un código a la vez.
¿Cómo mantengo segura mi clave?
Guarda las claves solo en tus servidores, da a cada app su propia clave, limítala a las direcciones de tus servidores y fija un límite de gasto diario. Si una clave pudo filtrarse, rótala o revócala desde tu cuenta.
Encontrarás más respuestas en el centro de ayuda