SMS verification API documentation

The SV Number API lets your software order temporary phone numbers and read incoming SMS codes without the website. Requests go to the same server as sms-verification-number.com, with the API key from your profile. Every method, parameter and error code is listed below, followed by the country and service codes you pass in requests.

• getBalance
• getCountryAndOperators
• getPrices
• getServicesAndCost
• getServicesAndCostWithStatistics
• getNumber
• getNumberV2
• setStatus
• getStatus
• getCurrentActivationsList
• Possible errors
• Appendix 1. List of countries
• Appendix 2. List of services

API is a protocol for interaction between your software and our server of temporary phone numbers for SMS activations and verifications.

The API is needed to automate the process of ordering temporary numbers and receiving SMS messages on your side. All requests (POST and GET are supported) should be sent to

https://sms-verification-number.com/stubs/handler_api

Attention!

The "lang" parameter sets the language and the currency of every answer. Available values: "ru" (rubles) and "en" (dollars). It is not enforced: a request without "lang" still works, but it falls back to rubles, and every figure you read back changes with it. The same Telegram number in Indonesia costs 0.23 with lang=en and 17.7 without it. Always send the parameter, and match it to the currency of your balance. The method name is the "action" parameter. Request rate limit per second (RPS): 150.

Useful options for clients working with the API.

To optimize costs, you can use the "getServicesAndCostWithStatistics" method, which provides information on the minimum prices for numbers in different countries. This will help you choose the most cost-effective options. "See where the cheapest numbers are."
How to view the % of successful SMS delivery by other users. "Learn more about SMS delivery statistics"
Set a maximum price for purchasing to avoid sudden price increases due to high demand "Learn more about how to limit the price for purchasing numbers."
If the site you need is not in the list, order the service code "ot" ("Not on list"). Numbers in that pool receive SMS from any sender that is not itself in the list. It is not a wildcard: a site that has its own code sends to that code, and "ot" will not pick those messages up. The catalogue also differs from country to country, so check a second country before deciding that a service is unavailable.

Get the API key in the section:Profile.

getBalance

Check Balance

https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getBalance&lang=LANG

Server response:

Example response:

463.02

getCountryAndOperators

Get all available countries and mobile operators for countries.

https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getCountryAndOperators&lang=LANG

Server response:

Example response in JSON:

[{"id":2,"name":"Russia","operators":{"any":"any","tele2":"tele2","tinkoff":"tinkoff","ttk":"ttk","yota":"yota"}},{"id":1,"name":"Ukraine","operators":{"any":"any","kyivstar":"kyivstar","life":"life","lycamobile":"lycamobile","mts":"mts","utel":"utel","vodafone":"vodafone"}}]

getPrices

Get current prices by country

https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getPrices&country=COUNTRY&lang=LANG

Server response:

Example response in JSON:

{"Country_Code":{"Service_Code":{"cost":Cost,"count":Quantity}}}

getServicesAndCost

Get current prices and the number of available numbers

https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCost&country=COUNTRY&operator=OPERATOR&service=SERVICE&lang=LANG

Server response:

Example response in JSON:

[{"id":"vk","name":"Vkontakte","price":29.88,"quantity":"19"},{"id":"ok","name":"Ok.ru","price":1.34,"quantity":"2776"},{"id":"wa","name":"Whatsapp","price":0,"quantity":"0"}]

getServicesAndCostWithStatistics

Get current prices, the number of online numbers with SMS delivery statistics by services/sites, and a list of minimum prices by country.

https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCostWithStatistics&country=COUNTRY&operator=OPERATOR&service=SERVICE&lang=LANG

Server response:

Example response in JSON:

[{"id":"tg","name":"Telegram","price":0.71,"quantity":1429,"deliverability":"25.82","cheap_prices_countries":[{"country_id":6,"country_name":"Indonesia","price":"0.20"},{"country_id":10,"country_name":"Viet
                            Nam","price":"0.33"},{"country_id":93,"country_name":"Costa
                            Rica","price":"0.36"},{"country_id":57,"country_name":"Iran","price":"0.36"},{"country_id":61,"country_name":"Senegal","price":"0.37"}]]
                        

                    
Field
                            
Example
                            
Description
                        
                        
id
                            
vk
                            
Service (site) code for API
                        
                        
name
                            
Vkontakte
                            
Service name
                        
                        
price
                            
29.88
                            
Current price
                        
                        
quantity
                            
19
                            
Number of numbers
                        
                        
deliverability
                            
12.71
                            
Percentage of SMS delivered, measured on orders placed by other users for that exact service and country. A zero means there is not enough data yet, not that messages fail to arrive: the field carried a non-zero value for 74 of 3835 pairs on 07 August 2026. Where it is zero, judge the pair by "quantity" instead.
                        
                        
cheap_prices_countries
                            
{"country_id":6,"country_name":"Indonesia","price":"0.20"}
                            
List of minimum prices by country
                        
                    
                    
                        
getNumber
                        
Order a number
                        
https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY&lang=LANG
                    
Field
                            
Type
                            
Description
                        
                        
api_key
                            
string
                            
Your API key, provides access to paid services. The API key should be kept secret
                        
                        
action
                            
string
                            
Method name
                        
                        
service
                            
string
                            
Service for which the number needs to be obtained, see "List of services"
                        
                        
operator
                            
string
                            
Mobile operator whose number needs to be obtained, see "List of countries"
                        
                        
country
                            
integer
                            
Country code from which you want to get numbers for SMS, see "List of countries"
                        
                        
lang
                            
string
                            
Localization ru or en
                        
                        
maxPrice
                            
string/float
                            
Maximum price you are willing to pay for a number (optional parameter)
                        
                    
                    
Server response:
                        
Server response
                                
Example
                                
Description
                            
                            
NO_BALANCE
                                
NO_BALANCE
                                
Insufficient balance on the API account
                            
                            
NO_NUMBERS
                                
NO_NUMBERS
                                
No numbers with the specified parameters, try again or try changing the country, operator.
                            
                            
ACCESS_NUMBER:ID:NUMBER
                                
ACCESS_NUMBER:234242:79991728822
                                
Get the order ID, the ordered temporary number with the country code.
                            
                            
WRONG_MAX_PRICE:MIN_PRICE
                                
WRONG_MAX_PRICE:13.21
                                
MIN_PRICE minimum price for which you can buy a number
                            
                        
                    
                        
getNumberV2
                        
Order a number
                        
https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getNumberV2&service=SERVICE&operator=OPERATOR&country=COUNTRY&lang=LANG
                    
Field
                            
Type
                            
Description
                        
                        
api_key
                            
string
                            
Your API key, provides access to paid services. The API key should be kept secret
                        
                        
action
                            
string
                            
Method name
                        
                        
service
                            
string
                            
Service for which the number needs to be obtained, see "List of services"
                        
                        
operator
                            
string
                            
Mobile operator whose number needs to be obtained, see "List of countries"
                        
                        
country
                            
integer
                            
Country code from which you want to get numbers for SMS, see "List of countries"
                        
                        
lang
                            
string
                            
Localization ru or en
                        
                        
maxPrice
                            
string/float
                            
Maximum price you are willing to pay for a number (optional parameter)
                        
                    
                    
Server response:
                        
Server response
                                
Example
                                
Description
                            
                            
NO_BALANCE
                                
NO_BALANCE
                                
Insufficient balance on the API account
                            
                            
NO_NUMBERS
                                
NO_NUMBERS
                                
No numbers with the specified parameters, try again or try changing the country, operator.
                            
                                
{
                                        "activationId": 4100,
                                        "phoneNumber": "62838*****",
                                        "activationCost": 2.4,
                                        "currency": 643,
                                        "countryCode": "6",
                                        "canGetAnotherSms": 1,
                                        "activationTime": "2025-07-26 13:50:08",
                                        "activationOperator": "any"
                                        }
                                
Get the order ID, the ordered temporary number with the country code.
                            
WRONG_MAX_PRICE:MIN_PRICE
                                
WRONG_MAX_PRICE:13.21
                                
MIN_PRICE minimum price for which you can buy a number
                            
                        
                    
                        
setStatus
                        
Change status
                        
https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=setStatus&id=ID&status=STATUS&lang=LANG
                    
Field
                            
Type
                            
Description
                        
                        
api_key
                            
string
                            
Your API key, provides access to paid services. The API key should be kept secret
                        
                        
action
                            
string
                            
Method name
                        
                        
id
                            
integer
                            
Order ID received when ordering a temporary number
                        
                        
status
                            
integer
                            
Specifies the status to be set for the order. A status that does not apply to the current state of the activation answers BAD_STATUS.
                        
                        
lang
                            
string
                            
Localization ru or en
                        
                    
                    
Available status values:
                        
3 - Request another SMS. Available only after the first code has arrived; before that the API answers BAD_STATUS.
                        
6 - Finish working with the ordered number
                        
8 - Cancel the number (only if no SMS has been received)

Server response:

Cancel a number if it is blocked

To cancel with a reason, send a POST request with a screenshot file as shown below. Regular cancellation via GET works as before.

Requests after receiving an SMS are reviewed manually. Funds are returned after approval.

curl 'https://sms-verification-number.com/stubs/handler_api' \
  -F 'api_key=APIKEY' \
  -F 'action=setStatus' \
  -F 'status=8' \
  -F 'id=123456' \
  -F 'lang=en' \
  -F 'reason[type]=1' \
  -F 'reason[notes]=The number is blocked' \
  -F 'reason[attachment]=@screenshot.png'

Upload the actual file, not its name, a link or Base64. In the example, @screenshot.png tells curl to read screenshot.png from the current folder and upload it. Replace screenshot.png with the path to your screenshot, keeping @. When sending from your application, attach the file to the reason[attachment] field using multipart/form-data; @ is only needed for curl.

In the JSON response, success indicates the result, msg provides an explanation, and errors lists invalid fields.

getStatus

Check the current status of the ordered number

https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getStatus&id=ID&lang=LANG

Server response:

getCurrentActivationsList

List of current orders

https://sms-verification-number.com/stubs/handler_api?api_key=APIKEY&action=getCurrentActivationsList&status=STATUS&limit=LIMIT&order=ORDER&orderBy=ORDERBY&lang=LANG

Server response:

Example response in JSON:

[ { "numberid": 1539723, "number": "380916172774", "status": 1 }, { "numberid": 1081409,
                            "number": "380916147785", "status": 1 } ]

Possible errors

Appendix 1. List of countries

Appendix 2. List of services