# Balance check request

## Balance check request

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/json/balance.php`

#### Headers

| Name                                           | Type   | Description                    |
| ---------------------------------------------- | ------ | ------------------------------ |
| Content-type<mark style="color:red;">\*</mark> | String | **`text/json; charset=utf-8`** |

#### Request Body

| Name                                       | Type   | Description                                                                                        |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------- |
| login<mark style="color:red;">\*</mark>    | String | Your login in the system                                                                           |
| token<mark style="color:red;">\*</mark>    | String | You can use a secret key instead of login and password. To obtain it, please contact your manager. |
| password<mark style="color:red;">\*</mark> | String | Your password in the system                                                                        |

{% tabs %}
{% tab title="200: OK In case the correct JSON document is received" %}

```json
{
    "money": "19023.9",
    "currency": "RUR",
    "information": 
        [
            {
                "type_sms": "sms",
                "area": "Tele2",
                "num_sms": "72029"
            }, 
            {
                "type_sms": "sms",
                "area": "Russia",
                "num_sms": "Unlim"
            }
        ]
}
```

{% endtab %}

{% tab title="400: Bad Request If an error occurs in the sent JSON document" %}

```json
{
    "error": "Error message"
}
```

{% endtab %}
{% endtabs %}

### Deciphering parameters in query responses

<table><thead><tr><th width="210.33333333333331">Parameter</th><th width="137">Data type</th><th>Description</th></tr></thead><tbody><tr><td>money</td><td>Int</td><td>Fund balance</td></tr><tr><td>currency</td><td>String</td><td>Currency</td></tr><tr><td>information.type_sms</td><td>String</td><td>Type of SMS</td></tr><tr><td>information.area</td><td>String</td><td>The direction in which a given quantity can be shippedво SMS</td></tr><tr><td>information.sms</td><td>Int</td><td>Number of available SMS messages for this destination</td></tr><tr><td>error</td><td>String</td><td><p></p><p>The error text can take the following values:</p><ul><li>Incorrect JSON document format </li><li>Your account is locked </li><li>Incorrect login or password </li><li>POST data is missing</li></ul></td></tr></tbody></table>