single-service activations

Get the number of available numbers by service

GEThttps://onlinesim.io/stubs/handler_api.php?action=getNumbersStatus

Returns, for one country, how many numbers are available for each service.

Keys are <service code>_0: the sms-activate service code (the service of getNumber; an Onlinesim service slug for services without such a code) and the suffix _0, always the same. Every known service is listed, 0 when there are no numbers.

No key is needed.

Parameters

query2
NameTypeDescription
action*string

Method name: getNumbersStatus

Enum:getNumbersStatus
countryinteger
≥ 0

Country ID from getCountries (id). Without it: Russia. Empty is Russia too; a non-numeric value gives BAD_COUNTRY, an unknown ID BAD_ACTION

Default:0Example:16

Responses

200Service → number of available numbers, or an error as text
text/plain
Schema
schemaoneOf
One Of
[0]string
Enum:BAD_COUNTRY
[1]string
Error answered as text by every action (also by the JSON ones):
  • BAD_KEY — the API key is wrong or missing
  • BANNED — the account is blocked
  • BAD_ACTION — unknown action or an error without its own code (for example a temporary error or too many concurrent requests); check the request and repeat it later
  • Too many requests. Please wait a moment before trying again. — the converter's limit of getNumber, getRentNumber, setStatus and setRentStatus (3 requests per second, 150 per 30 seconds)
Enum:BAD_KEYBANNEDBAD_ACTIONToo many requests. Please wait a moment before trying again.

Examples

badCountry

Empty or non-numeric country

BAD_COUNTRY
application/json
Schema
schemaobject
[additionalProperties]integer | string
Available numbers (a number; in rare cases a string)

Examples

services

Part of the list

{
  "vk_0": 2016,
  "go_0": 2015,
  "tg_0": 138,
  "wa_0": 0
}

Code Samples

Generating examples...