API de Activación por SMS

El formato común de activación en texto plano, para herramientas que ya lo utilizan. Las nuevas integraciones también pueden usar la API REST.

Introducción a los números de verificación

Cada llamada es una solicitud GET (o POST) a https://snsverify.com/stubs/handler_api.php con tu clave API y un parámetro de acción. La clave se obtiene de la página de claves API en tu consola; mantenla privada, puede gastar tu saldo. Las respuestas son líneas de texto cortas como ACCESS_NUMBER o STATUS_OK, o JSON para las acciones de lista, igual que otros servicios que usan este formato.

Misma cuenta, mismas reglas. Los números comprados aquí usan los mismos precios, la misma ventana de 20 minutos y el mismo reembolso automático que el sitio web. Los códigos de servicio son los nombres en minúsculas que ves en nuestro sitio (whatsapp, telegram, google); los códigos de país son ISO: us, gb, nl, de, af, al, dz, ao, ai, ar, am, aw, au, at, az, bs, bh, bd, bb, by, be, bz, bj, bt, bo, ba, bw, br, bn, bg, bi, kh, cm, ca, td, cl, cn, co, km, hr, cy, cz, dk, dj, dm, ec, eg, er, ee, sz, et, fj, fi, fr, ga, gm, ge, gh, gi, gr, gd, gp, gt, gn, gy, ht, hn, hk, hu, is, in, id, iq, ie, il, it, jm, jp, jo, kz, ke, kw, kg, la, lv, lb, ls, lr, lt, lu, mo, mg, mw, my, mv, ml, mt, mr, mu, mx, md, mc, mn, me, ms, ma, mz, na, np, nz, ni, ne, ng, no, om, pk, pa, py, pe, ph, pl, pt, qa, ro, rw, sn, rs, sc, sg, sk, si, so, za, es, sr, se, ch, tw, tj, tz, th, tg, tn, tr, tm, ug, ua, uy, uz, ve, vn, ye, zm, zw.

getBalance (GET) [+]

Tu saldo en USD.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getBalance

Respuesta

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Códigos de servicio que puedes comprar (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getServicesList

Respuesta

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries (GET) [+]

Códigos de país (ISO, minúsculas) y códigos de marcación (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getCountries

Respuesta

{"gb":{"name":"United Kingdom","dial":"44"}}

getPrices (GET) [+]

Precios en USD por país y servicio. Ambos filtros son opcionales.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getPrices&service=whatsapp&country=gb

Respuesta

{"gb":{"whatsapp":{"cost":0.94,"count":100}}}

getNumber (GET) [+]

Compra un número. Devuelve el id de activación y el número con su código de país.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=whatsapp&country=gb

Respuesta

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (aún no hay código), STATUS_OK:<code>, STATUS_WAIT_RETRY:<último código> (se solicitó otro código), STATUS_CANCEL (cancelado o reembolsado).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getStatus&id=AC-7K2M9QX4PB

Respuesta

STATUS_OK:482915

setStatus (GET) [+]

status=1 listo (ACCESS_READY), 3 otro código (ACCESS_RETRY_GET), 6 finalizar (ACCESS_ACTIVATION), 8 cancelar con reembolso completo si no llegó ningún código (ACCESS_CANCEL).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

Respuesta

ACCESS_RETRY_GET

Flujo típico

Llama a getNumber con servicio y país. Guarda el id de activación y proporciona el número a la aplicación.
Llama a setStatus con status=1 cuando la aplicación haya enviado el SMS (opcional, solo marca la activación como lista).
Consulta getStatus cada 3 a 5 segundos hasta que responda STATUS_OK con el código.
¿Necesitas otro código? setStatus status=3, luego consulta nuevamente hasta que STATUS_OK muestre el nuevo código.
Listo: setStatus status=6. ¿No hay código y quieres tu dinero ahora? setStatus status=8 (solo antes de que llegue un código). De lo contrario, la activación se reembolsa automáticamente después de 20 minutos.

Respuestas de error

BAD_KEY	Falta o es incorrecta la clave API.
BAD_ACTION	Acción desconocida.
BAD_SERVICE	Código de servicio desconocido.
BAD_COUNTRY	El servicio no se vende en ese país.
NO_BALANCE	Saldo insuficiente.
NO_NUMBERS	No hay números disponibles en este momento. Inténtalo de nuevo en un momento.
NO_ACTIVATION	Id de activación desconocido o no es tuyo.
EARLY_CANCEL_DENIED	Ya ha llegado un código, por lo que la activación no se puede cancelar.
TOO_MANY_REQUESTS	Más de 300 solicitudes en un minuto.
NO_ACTIVATIONS	Ya hay 20 activaciones abiertas.

Límites: 300 solicitudes por minuto por clave, hasta 20 activaciones abiertas por cuenta. Precios actualizados al 2026-11-04