v1

Get list of available services and countries

POST{yourserver}/getServices

This request is sent from Onlinesim server to yours every minute to get a quantity of available numbers. Your server should return a relevant list of available numbers in format described below.

Your partner's API key will be passed in the request in a payload.

Parameters

header1
NameTypeDescription
Authorization*string

see more here

Request Body

Request payload from Onlinesim server

Content-Typeapplication/json
Schema
schemaobject
actionstringRequired
Method name, in this case GET_SERVICESEnum:GET_SERVICESDefault:GET_SERVICES
keystringRequired
API key of your Onlinesim partner's profile

Examples

Example payload of Onlinesim server GET_SERVICES request
{
  "action": "GET_SERVICES",
  "key": "apikey"
}

Responses

200The response of your server for GET_SERVICES request must be in following format:

Headers

NameTypeDescription
Content-Typestring

Content type header and encoding scheme

Content-Typeapplication/json
Schema
schemaobject
countryListobject[]RequiredList of countries and the respective available number counts per operator and service
statusstringRequired
Request status (SUCCESS or ERROR)Enum:SUCCESSERROR

Examples

Response example from your server50 lines
{
  "countryList": [
    {
      "country": "russia",
      "operatorMap": {
        "any": {
          "vk": 10,
          "ok": 25,
          "wa": 52
        },
        "beeline": {
          "vk": 10,
          "ok": 15,
          "wa": 20
        },
        "megafon": {
          "vk": 0,
          "ok": 10,
          "wa": 32
        }
      }
    },
    {
      "country": "ukraine",
      "operatorMap": {
        "any": {
          "vk": 10,
          "ok": 50,
          "wa": 132
        },
        "life": {
          "vk": 0,
          "ok": 10,
          "wa": 32
        },
        "vodafone": {
          "vk": 10,
          "ok": 10,
          "wa": 0
        },
        "kyivstar": {
          "vk": 0,
          "ok": 30,
          "wa": 100
        }
      }
    }
  ],
  "status": "SUCCESS"
}

Code Samples

Generating examples...