single-service activations

Price of a number for a service

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

Price (USD) of one number of the country for the service. A service without its own price in this country gets the country's price for "other services". POST with the same parameters works too.

Security

Parameters

query3
NameTypeDescription
service*string

Service slug from the service list. The value is lowercased and . is replaced with _; a few old names are mapped to the current ones (for example blizzard → battle_net)

countryinteger

Country code. Default: the country saved in the profile settings

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

200Price or an error
Content-Typeapplication/json
Schema
schemaoneOf
One Of
[0]object
[1]object
[2]object

Examples

success

Price

{
  "response": "1",
  "price": 0.36
}
UNDEFINED_COUNTRY

Unknown country

{
  "response": "UNDEFINED_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...