Skip to content


The method is aimed for getting the account state.


To get the account state, you have to execute a request at:


For idInstance and apiTokenInstance request parameters, refer to section Before you start.


Response parameters#

Parameter Type Description
stateInstance string Account state. Have variants:
notAuthorized - Account is not authorized. For account authorization refer to Before you start section
authorized - Account is authorized
blocked - Account banned
sleepMode - Account is in sleep mode. The state is possible when the phone is switched off. After the phone is switched on, it may take up to 5 minutes for the account state to be changed to authorized.
starting - The account is in the process of starting up (service mode). An instance, server, or instance in maintenance mode is rebooting. It may take up to 5 minutes for the account state to be set to authorized.

Response body example#

    "stateInstance": "authorized"

Errors GetStateInstance#

For a list of errors common to all methods, refer to Common errors section

Python request example#

import requests

url = "{{idInstance}}/getStateInstance/{{apiTokenInstance}}"

payload = {}
headers= {}

response = requests.request("GET", url, headers=headers, data = payload)