vavsms

API Documentation

Last updated: December 15, 2025

Introduction

This documentation explains how to use our API to automate your orders for both Single SMS services and number rental services.

Base URL

All API requests should be made to:

https://vavsms.com/api

Authentication

Include your API key in the URL as shown in the examples below. You can find your API key on your profile page.

Single SMS Service

GET /getCategories

List Categories

Returns a list of available categories for Single SMS services.

Response

[
  {
    "id": 1,
    "name": "Google/Youtube",
    "cheapest": 0.30,
    "maxRate": 75
  },
  ...
]

GET /getServices/{category_id}

List Services by Category

Returns a list of services available for the specified category.

Name	Type	Description
category_id	integer	ID of the category

Response

[
  {
    "id": 1,
    "name": "United States",
    "price": 1.20,
    "workRate": 25,
    "category": "Google/Youtube"
  },
  ...
]

GET /getServiceDetails/{service_id}

Get Service Details

Returns the price and stock information for a specific service.

Name	Type	Description
service_id	integer	ID of the service

Response

{
  "id": 1,
  "price": 1.20,
  "stock": 250
}

GET /{api_key}/getBalance

Get User Balance

Returns the current balance of the user.

Name	Type	Description
api_key	string	Your API key

Response

{
  "balance": 30
}

GET /{api_key}/getNumber/{service_id}

Order New Number

Orders a new number for the specified service.

Name	Type	Description
api_key	string	Your API key
service_id	integer	ID of the service

Response

{
  "success": true,
  "message": "Number purchased successfully.",
  "number_id": 10001,
  "number": "+18887776655"
}

Note: Store the number_id and number values, as you'll need them to read messages.

GET /{api_key}/getMessage/{number_id}

Get Received Message

Retrieves the received message for the specified number.

Name	Type	Description
api_key	string	Your API key
number_id	integer	ID of the number

Response

{
  "code": "888777",
  "text": "G-888777 is your Google verification code.",
  "id": "10001",
  "status": 0
}

Status codes: 0 = Waiting for message, 1 = Message received (code shown), -1 = Number is cancelled

GET /{api_key}/cancelNumber/{number_id}

Cancel Number

Cancels the specified number. If cancelled within 10 minutes, the balance will be refunded.

Name	Type	Description
api_key	string	Your API key
number_id	integer	ID of the number

Response

{
  "success": true,
  "message": "Number canceled and balance refunded."
}

Number Rental Service

GET /getRentCountries

Get Rent Countries

Returns a list of available countries for number rental.

Response

[
  {"id": 0, "name": "Russia"},
  ...
]

GET /getRentServices/{country_id}/{time}

Get Rent Services

Retrieves a list of available rental services for a specific country and rental duration.

Name	Type	Description
country_id	integer	The ID of the country (obtained from Get Rent Countries)
time	integer	Rental duration in hours (4, 12, or multiples of 24, up to 672)

Response

[
  {
    "id": "go",
    "name": "Google",
    "stock": {"current": 10, "total": 20},
    "price": 1.50
  },
  ...
]

GET /getRentNumber/{api_key}/{country_id}/{service_id}/{time}

Order Rent Number

Rents a number for the specified service and country.

Name	Type	Description
api_key	string	Your API key
country_id	integer	The ID of the country
service_id	string	The ID of the service
time	integer	Rental duration in hours

Response

{
  "success": true,
  "number_id": 100,
  "number": "+18887776655"
}

Note: Store the number_id value, as you'll need it to read messages.

GET /getRentActivations/{api_key}

Get Rent Activations

Returns a list of active rent numbers for the user.

Name	Type	Description
api_key	string	Your API key

Response

{
  "success": true,
  "number_id": 100,
  "number": "+79998887766"
}

GET /getRentMessage/{api_key}/{number_id}

Get Rent Message

Retrieves messages received for the specified rented number.

Name	Type	Description
api_key	string	Your API key
number_id	integer	The ID of the rented number

Response

{
  "id": 100,
  "number": "+18887776655",
  "service": "Google",
  "country_id": 0,
  "message": [
    {
      "from": "+15559876543",
      "message": "Your verification code is 123456",
      "time": 1625097600
    }
  ],
  "msgcount": 1,
  "start_time": 1625097000,
  "end_time": 1625183400
}

GET /cancelRentNumber/{api_key}/{number_id}

Cancel Rent Number

Cancels the specified rented number. Cannot cancel after 20 minutes or if SMS received.

Name	Type	Description
api_key	string	Your API key
number_id	integer	ID of the rented number

Response

{
  "success": true,
  "message": "Number has been cancelled successfully. Your money has been refunded to your account."
}

GET /getRentRenewPrice/{api_key}/{number_id}/{time}

Get Rent Renew Price

Returns the price to renew a rented number.

Name	Type	Description
api_key	string	Your API key
number_id	integer	ID of the rented number
time	integer	Renewal duration (optional)

Response

{
  "success": true,
  "price": 0.50,
  "number": "+79998887766"
}

GET /renewRentNumber/{api_key}/{number_id}/{time}

Renew Rent Number

Renews the specified rented number.

Name	Type	Description
api_key	string	Your API key
number_id	integer	ID of the rented number
time	integer	Renewal duration (optional)

Response

{
  "success": true,
  "message": "Number has been renewed successfully."
}

Error Handling

The API uses HTTP response codes to indicate the success or failure of requests. Common error codes include:

200: Success
400: Bad Request
401: Unauthorized
404: Not Found
500: Internal Server Error

Detailed error messages may be included in the response body for debugging purposes.

Rate Limiting

Our API is limited to 100 requests per 10 seconds by IP address. Exceeding the limit will result in a 1 minute IP block.

Support

For additional support or questions about the API, please contact us via the support system.

Countries: 167
Virtual numbers: 4.347.528
Support requests: 66