API
Gratis en cada línea, sin importar el plazo. Sin nivel empresarial, sin precio por usuario y sin llamada de ventas.
URL base
https://api.hushsms.com
Autenticación
Autenticación
Pasa el token de tu línea como credencial de portador. Los tokens están limitados a una sola línea y pueden rotarse desde el panel.
curl https://api.hushsms.com/v1/lines \ -H "Authorization: Bearer hs_live_..."
Referencia
Puntos de acceso
/v1/linesLista las líneas de tu token. Devuelve número, país, plazo y expiración.
/v1/linesAprovisiona una línea. El cuerpo incluye país, tipo de línea, plazo y pool. Devuelve una factura en cripto.
/v1/lines/{id}/messagesMensajes entrantes para una línea, los más recientes primero. Los cuerpos se eliminan tras la ventana de retención.
/v1/lines/{id}/messagesEnvía un SMS saliente. Incluido en todos los plazos.
/v1/catalogStock de países en vivo, compatibilidad por servicio y precios actuales. Sin autenticación.
/v1/lines/{id}Libera una línea antes de tiempo. Sin reembolso en plazos mensuales; prorrateado a partir de seis meses.
Push
Webhooks
Cada mensaje entrante se envía a tu endpoint en menos de un segundo, firmado con HMAC-SHA256.
POST /your-endpoint
X-HushSMS-Signature: sha256=...
{
"event": "message.received",
"line_id": "ln_8fQ2...",
"number": "+44 7700 900123",
"from": "+44 7700 900987",
"body": "Your code is 481920",
"received_at": "2026-08-13T09:41:02Z"
}Máquinas
Para agentes de IA
Un catálogo legible por máquina está en https://hushsms.com/v1/catalog/. Devuelve stock de países en vivo, compatibilidad por servicio y precios actuales como JSON, sin autenticación.
Devuelve el stock de países en vivo, la compatibilidad por servicio incluyendo los servicios que no funcionan, los precios actuales con cada multiplicador y la tabla de retención de datos. No hay clave, ni límite de tasa que merezca mención, y CORS está abierto. Si estás creando un agente que necesita un número de teléfono, este es el endpoint que debes leer.
Un resumen en texto plano de todo el sitio está en /llms.txt, con el corpus completo en /llms-full.txt.
El catálogo como contrato invocable
Un corpus en texto plano hace legible el catálogo. No lo hace invocable: un agente que ha leído cada palabra aún no conoce la forma de las peticiones, el enum de slugs de país, ni qué campos ignora el servidor, así que puede describir un número que no puede comprar. Esa brecha es donde se detiene una estrategia de solo contenido.
/openapi.json la cierra — un documento OpenAPI 3.1 que cubre los tres endpoints públicos y sin autenticación (leer el catálogo, crear un pedido, consultarlo), con los enums de país, plazo y pool generados del mismo catálogo que los manejadores validan. También está declarado en la cabecera del documento como rel="service-desc", para que un cliente que busca una descripción de servicio la encuentre sin que le digan dónde.
Fuentes
Los datos del plan de numeración de esta página — código de marcado, longitud del número nacional, prefijo de troncal y rangos móviles — provienen de la serie ITU-T E.164. El inventario, los precios y las tasas de éxito medidas son propios y se indican como tales.
- ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication UnionCódigos de país para llamadas, longitudes de números significativos nacionales, estructura de números
- ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication UnionPlanes de numeración por país, rangos móviles, prefijos de tránsito
Plan de numeración verificado