single-service activations

Countries with services, prices and stock

GEThttps://onlinesim.io/api/getNumbersStats.php

One country with its services, prices (USD) and the number of available numbers; country=all returns all countries as a map: country code → country. A successful answer has no response field. POST with the same parameters works too.

Public method: no key is needed. A key that is sent is still checked (an invalid one gives HTTP 456); an OAuth token, if sent, must carry sms-scope.

Answers are cached for 60 seconds.

Parameters

query3
NameTypeDescription
countrystring

Country code, or all (also 0 or an empty value) for all countries

Default:44
servicestring

Keeps only the services whose key service_<slug> contains this value (case-insensitive). Works only for one country, ignored for country=all

langstring

Language of the texts in the answer (country and service names, status texts): fr, de, ru, en or zh. Every method accepts it; methods without such texts answer the same in any language. Field names, error codes and other fixed values stay in English. Without the parameter: ru for getTariffs, getNumbersStats and getFreeList; otherwise the language of the profile for requests with a key, English for requests without one. An unsupported value falls back to the default language

Enum:frderuenzh

Responses

200One country, all countries or an error
Content-Typeapplication/json
Schema
schemaoneOf
One Of
[0]object
[1]objectWith country=all or country=0: country code → country
[2]object
[3]object

Examples

country20 lines

One country

{
  "name": "united_kingdom",
  "position": 2,
  "code": 44,
  "other": false,
  "new": false,
  "enabled": true,
  "services": {
    "service_vkcom": {
      "count": 363,
      "popular": false,
      "code": 44,
      "price": 0.36,
      "id": 1,
      "service": "VK",
      "slug": "vkcom"
    }
  },
  "locale_name": "United Kingdom"
}
NO_COUNTRY

Unknown country

{
  "response": "NO_COUNTRY"
}
429HTTP 429: more than 400 requests per minute from one profile (from one IP for requests without a key), or more than 200 requests per minute from one profile to getNum, getPrice, getState and setOperationOk together
Content-Typeapplication/json
Schema
schemaobject
responsestringRequired
Error code. The codes any method can return are listed in the introduction; each method lists its own. The list is not closed: treat an unknown code as a generic error and log it.

Examples

Rate limit

Request rate limit exceeded

{
  "response": "TRY_AGAIN_LATER"
}
456HTTP 456: the API key is invalid or the OAuth token has expired. Public methods answer the same way when an invalid key is sent
Content-Typeapplication/json
Schema
schemaobject
responsestringRequired
Error code. The codes any method can return are listed in the introduction; each method lists its own. The list is not closed: treat an unknown code as a generic error and log it.

Examples

Invalid key

Invalid API key or expired token

{
  "response": "ERROR_WRONG_KEY"
}

Code Samples

Generating examples...