VioSMS Public API

Integrate VioSMS into your own applications to automatically buy and verify numbers. All API endpoints require an API Key.

Authentication

Authenticate your API requests by including your secret API key in the Authorization HTTP header.

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

Returns your current account balance.

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

Returns a list of all available services and their minimum prices.

Note: If you are looking for a specific service like Hinge or Tinder, use this endpoint to fetch all available service codes dynamically.

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

Retrieve a list of all available countries and their codes. You must use the code from this response when purchasing a number.

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

Purchases a new phone number. The cost will be deducted from your balance.

ParameterIntegrate VioSMS into your own applications to automatically buy and verify numbers. All API endpoints require an API Key.
servicestring*

Service code (e.g. "wa" for WhatsApp).

countrystring*

Country code (e.g. "161" for Turkey).

operatorstring

Optional operator code. Default is "any".

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

Checks the SMS verification status of an activation.

ParameterIntegrate VioSMS into your own applications to automatically buy and verify numbers. All API endpoints require an API Key.
idstring*

The unique Activation ID returned from the buy endpoint.

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

Cancels an activation and refunds the cost if no SMS was received.

ParameterIntegrate VioSMS into your own applications to automatically buy and verify numbers. All API endpoints require an API Key.
idstring*

The unique Activation ID to cancel.

Request
{
  "id": "cuid..."
}
Response
{
  "status": "success",
  "message": "Activation cancelled and refunded"
}