get getNumber

http://api-conserver.onlinesim.io/stubs/handler_api.php?action=getNumber
single-service activations

This request allows you to order a phone number of a specific country to receive SMS from a selected service.

This is the main service provided by Onlinesim: you can use virtual numbers to receive verification codes or any other information contained in SMS messages.

IMPORTANT NOTE!
Please note, that number is issued for 15 minutes (time period depends on the country and service and can differ) and after the operation is closed this number will not be available.

Security

Parameters

action
Required
Method name, in this case `getNumber`
In: query
Schema:
  • string
    Example: "getNumber"
    Enum: getNumber
service
Required

Service slug (short service name, required upon ordering a number, see getNumbersStatus request)

In: query
Schema:
  • string
    Example: "3223"
country
Required

Country ID (see getCountries request)

In: query
Schema:
  • integer
    Example: 46
phoneException
Array for mask exception (including the country code)
For example: with value [911,912123] won't issue numbers of India, that start with 911* and 912123*
In: query
Example: 908
Schema:
  • mixed
    Example: 0
    One Of:
    • integer
      Example: 0
    • array
      Example: []
      Items:

Responses

200

Successful `getNumber` response from the server: either returns an operation ID and issued number for SMS receiving or throws an exception.
Content Type:
text/html
  • Schema
  • Examples
  • string

    ACCESS_NUMBER:OPERATION_ID:ISSUED_NUMBER

    Example: "ACCESS_NUMBER:10000:46050608210"