POST{yourserver}/getServices

Get list of available services and countries

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_SERVICES

Enum: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

200

The 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[]Required

List 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 serverexample_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...