Skip to content

GET /api/getFreeList

Get list of free numbers

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 receiving, for example for testing.

WARNING

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 personal information.

INFO

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.

Parameters

NameTypeDescription
countryinteger
≥ 1

‘International dialing code of the country (Е.164 standard, without
“+” sign), see
country list’

Default:7Example:46
numberstring

Free phone number, without country code

Example:9100100101
langstring

Response language:
fr - French,
de - German,
ru - Russian,
en - English,
zh - Chinese.
Please note that the translation applies only to string field values, such as service names or country names. Field names themselves, error messages, and standard values (for example, true/false for boolean fields) remain in English.

Enum:frderuenzhDefault:ruExample:en

Responses

200

Successful response for getFreeList request: the server returns
information on free numbers and messages they’ve received.

Code Samples