API Pública de VioSMS

Integra VioSMS en tus aplicaciones para comprar y verificar números automáticamente. Todos los endpoints requieren una Clave API.

Autenticación

Autentica tus peticiones API incluyendo tu clave API secreta en la cabecera Authorization.

HTTP Header
Authorization: Bearer YOUR_API_KEY
GET/api/v1/balance

Devuelve el saldo actual de tu cuenta.

Respuesta
{
  "status": "success",
  "balance": 15.50,
  "currency": "USD"
}
GET/api/v1/services

Devuelve una lista de todos los servicios disponibles y sus precios mínimos.

Nota: Si está buscando un servicio específico como Hinge o Tinder, use este punto final para obtener todos los códigos de servicio disponibles de forma dinámica.

Respuesta
{
  "status": "success",
  "data": [
    {
      "code": "wa",
      "name": "WhatsApp",
      "price": 0.25
    }
  ]
}
GET/api/v1/countries

Recupere una lista de todos los países disponibles y sus códigos. Debe usar el code de esta respuesta al comprar un número.

Respuesta
{
  "status": "success",
  "data": [
    {
      "code": "turkey",
      "name": "Turkey"
    },
    {
      "code": "62",
      "name": "Indonesia"
    }
  ]
}
POST/api/v1/buy

Compra un nuevo número de teléfono. El coste se deducirá de tu saldo.

ParámetroIntegra VioSMS en tus aplicaciones para comprar y verificar números automáticamente. Todos los endpoints requieren una Clave API.
servicestring*

Código del servicio (ej. "wa" para WhatsApp).

countrystring*

Código de país (ej. "161" para Turquía).

operatorstring

Código de operador opcional. Por defecto es "any".

Petición
{
  "service": "wa",
  "country": "161"
}
Respuesta
{
  "status": "success",
  "data": {
    "id": "cuid...",
    "phone": "+1234567890",
    "price": 1.25,
    "expiresAt": "2026-06-05T12:00:00.000Z"
  }
}
GET/api/v1/status

Comprueba el estado de verificación SMS de una activación.

ParámetroIntegra VioSMS en tus aplicaciones para comprar y verificar números automáticamente. Todos los endpoints requieren una Clave API.
idstring*

El ID de Activación único devuelto por la compra.

Respuesta
{
  "status": "success",
  "data": {
    "id": "cuid...",
    "status": "SMS_RECEIVED",
    "phone": "+1234567890",
    "smsCode": "456789",
    "smsText": "WhatsApp code: 456789"
  }
}
POST/api/v1/cancel

Cancela una activación y reembolsa el coste si no se recibió ningún SMS.

ParámetroIntegra VioSMS en tus aplicaciones para comprar y verificar números automáticamente. Todos los endpoints requieren una Clave API.
idstring*

El ID de Activación único para cancelar.

Petición
{
  "id": "cuid..."
}
Respuesta
{
  "status": "success",
  "message": "Activation cancelled and refunded"
}