get getFreeList
https://onlinesim.io/api/getFreeList
Depending on the parameters returns information on available countries with free numbers, received messages and the list of restricted services.
Without parameters: returns a list of available countries with free numbers, messages received by the first number from the list and the list of restricted services.
With country
parameter: returns a list of available free numbers of that country, messages received by the first number from the list and the list of restricted services.
With country
and number
parameters: returns a list of SMS messages received by this number and the list of restrices services.
You can send this request to get a number that can be used for SMS receiption later on, for example for testing.
IMPORTANT NOTES!
Please note that some services are prohibited for use (and SMS from these services are not available), you can find the list of such services on the front page or in Public offer.
It is worth to mention that since the access for these numbers is public we do not recommend to use them to create accounts for personal use with any confidential information.
Security
Parameters
country
Country code (Е.164 standard, without "+" sign), see getNumbersStats
query
- integerExample:
46
>= 1
number
query
- stringExample:
9100100101
lang
Response language:
fr
- French
de
- German
ru
- Russian
en
- English
zh
- Chinese
query
- stringExample:
en
Enum:fr
de
ru
en
zh
Responses
200
- Schema
- Examples
- objectProperties:
response
mixed1, if the request has been completed successfully, or an error messagecountries
arrayArray of countries with their corresponding phone codesItems:- object
numbers
objectmessages
objectFree numbers messagesignore
stringList of restricted services (SMS from these services are unavailable)