get getFreePhoneList

https://onlinesim.io/api/getFreePhoneList
free numbers

DEPRECATED, use getFreeList instead

This request allows to retrieve a list of free numbers of a specific country (or a full list of available free numbers if country is not specified).

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

In: query
Schema:
  • integer
    Example: 46
    >= 1
lang

Response language:
fr - French
de - German
ru - Russian
en - English
zh - Chinese

In: query
Schema:
  • string
    Example: "en"
    Enum: fr de ru en zh

Responses

200

Successful response for `getFreePhoneList` request: the server returns a list of free phone numbers available for SMS receiving or throws an exception.
Content Type:
application/json
  • Schema
  • Examples
  • object
    Example: {"response":1,"numbers":[{"number":"9108501010","country":46,"updated_at":"2022-07-11 00:12:26","data_humans":"17 hours ago","full_number":"+46050101010","country_text":"Швеция","maxdate":"2022-07-11 00:15:26","status":"disabled"}]}
    Properties:
    • response
      mixed
      1, if the request has been completed successfully, or an error message
      Example: 1
      One Of:
      • integer
        Example: 0
      • string
        Example: "string"
    • numbers
      array
      Example: [{"number":"9108501010","country":46,"updated_at":"2022-07-11 00:12:26","data_humans":"17 hours ago","full_number":"+46050101010","country_text":"Швеция","maxdate":"2022-07-11 00:15:26","status":"disabled"}]
      Items:
      • object
        Example: {"number":"9108501010","country":46,"updated_at":"2022-07-11 00:12:26","data_humans":"17 hours ago","full_number":"+46050101010","country_text":"Швеция","maxdate":"2022-07-11 00:15:26","status":"disabled"}