API Pública VioSMS

Integre o VioSMS nas suas aplicações para comprar e verificar números automaticamente. Todos os endpoints requerem uma Chave API.

Autenticação

Autentique as suas solicitações incluindo a sua chave API no cabeçalho Authorization.

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

Retorna o saldo atual da sua conta.

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

Retorna uma lista de todos os serviços disponíveis e os seus preços mínimos.

Nota: Se você estiver procurando por um serviço específico como Hinge ou Tinder, use este endpoint para buscar todos os códigos de serviço disponíveis dinamicamente.

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

Recupere uma lista de todos os países disponíveis e seus códigos. Você deve usar o code desta resposta ao comprar um número.

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

Compra um novo número de telefone. O custo será deduzido do seu saldo.

ParâmetroIntegre o VioSMS nas suas aplicações para comprar e verificar números automaticamente. Todos os endpoints requerem uma Chave API.
servicestring*

Código do serviço (ex. "wa" para WhatsApp).

countrystring*

Código do país (ex. "161" para a Turquia).

operatorstring

Código de operador opcional. O padrão é "any".

Solicitação
{
  "service": "wa",
  "country": "161"
}
Resposta
{
  "status": "success",
  "data": {
    "id": "cuid...",
    "phone": "+1234567890",
    "price": 1.25,
    "expiresAt": "2026-06-05T12:00:00.000Z"
  }
}
GET/api/v1/status

Verifica o status de verificação SMS de uma ativação.

ParâmetroIntegre o VioSMS nas suas aplicações para comprar e verificar números automaticamente. Todos os endpoints requerem uma Chave API.
idstring*

O ID de Ativação único retornado pela compra.

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

Cancela uma ativação e reembolsa o custo se nenhum SMS foi recebido.

ParâmetroIntegre o VioSMS nas suas aplicações para comprar e verificar números automaticamente. Todos os endpoints requerem uma Chave API.
idstring*

O ID de Ativação único para cancelar.

Solicitação
{
  "id": "cuid..."
}
Resposta
{
  "status": "success",
  "message": "Activation cancelled and refunded"
}