SMS.RU API

https://sms.ru/api
Admin
SMS.RU API is a web service for sending SMS messages, checking account balance, managing contacts,...
Tokens:29,057
Snippets:205
Trust Score:9.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /callback/add

Source: https://sms.ru/api/callback_add

Registers a callback URL to receive notifications.

```APIDOC
## GET /callback/add

### Description
Registers a callback URL to receive notifications from the SMS.ru service.

### Method
GET

### Endpoint
https://sms.ru/callback/add

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **url** (string) - Required - The URL to receive callback notifications.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
```

--------------------------------

### GET /callback/get

Source: https://sms.ru/api/callback_get

Retrieves a list of all webhook handlers registered by the user.

```APIDOC
## GET /callback/get

### Description
Retrieves the list of all webhook handlers previously registered by the user.

### Method
GET

### Endpoint
https://sms.ru/callback/get

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API key found in the personal account dashboard.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
- **login** (string) - Required (if api_id not used) - Your phone number (login).
- **password** (string) - Required (if api_id not used) - Your account password.

### Response
#### Success Response (200)
- **status** (string) - Status message (e.g., "OK").
- **status_code** (integer) - Success code (e.g., 100).
- **callback** (array) - List of registered webhook URLs.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "callback": [
        "http://yoursite.ru/callback.php",
        "http://anothersite.ru/callback/index.php"
    ]
}
```

--------------------------------

### Check authentication with PHP file_get_contents

Source: https://sms.ru/api/auth_check

Uses file_get_contents to perform a simple GET request for authentication verification.

```php
$body = file_get_contents("https://sms.ru/auth/check?api_id=[зарегистрируйтесь, чтобы получить api_id]&json=1"); 
//$body = file_get_contents("https://sms.ru/auth/check?login=79255070602&password=[ваш пароль]&json=1"); 


$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### API Response Formats

Source: https://sms.ru/api/send

Examples of successful and error responses from the API, shown in both JSON and plain text formats.

```json
{
    "status": "OK", // Запрос выполнен успешно (нет ошибок в авторизации, проблем с отправителем, итд...)
    "status_code": 100, // Успешный код выполнения
    "sms": {
        "79255070602": {
            "status": "OK", // Возможные варианты: OK или ERROR.
            "status_code": 100, // Успешный код выполнения, сообщение принято на отправку
            "sms_id": "000000-10000000" // ID сообщения
        },
        "74993221627": {
            "status": "ERROR",
            "status_code": 207, // Код ошибки
            "status_text": "На этот номер (или один из номеров) нельзя отправлять сообщения, либо указано более 100 номеров в списке получателей" // Описание ошибки
        }
    } ,
    "balance": 4122.56 // Ваш баланс после отправки
}
```

```text
100 // запрос выполнен успешно
000000-10000000 // id первого сообщения
207 // код ошибки второго сообщения
balance=4122.56 // ваш баланс после отправки
```

--------------------------------

### GET https://sms.ru/auth/check

Source: https://sms.ru/api/auth_check

Verifies the validity of the provided api_id.

```APIDOC
## GET https://sms.ru/auth/check

### Description
Checks if the provided api_id is valid and active.

### Method
GET

### Endpoint
https://sms.ru/auth/check

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
```

--------------------------------

### GET /stoplist/add

Source: https://sms.ru/api/stoplist_add

Adds a phone number to the stoplist.

```APIDOC
## GET /stoplist/add

### Description
Adds a phone number to the stoplist to prevent future SMS delivery.

### Method
GET

### Endpoint
https://sms.ru/stoplist/add

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **stoplist_phone** (string) - Required - The phone number to add to the stoplist.
- **stoplist_text** (string) - Optional - The reason for adding the number to the stoplist.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
```

--------------------------------

### Query SMS cost using PHP file_get_contents

Source: https://sms.ru/api/cost

A basic example using file_get_contents to fetch cost data. Using the official PHP library is recommended over this manual implementation.

```php
$body = file_get_contents("https://sms.ru/sms/cost?api_id=[зарегистрируйтесь, чтобы получить api_id]&to=79255070602&msg=".urlencode(iconv("windows-1251","utf-8","Привет!")))."&json=1");

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### Query SMS cost using cURL

Source: https://sms.ru/api/cost

A command-line example for checking costs. Note that Windows users should remove the backslashes before special characters like ? and &.

```bash
curl -d "msg=hello world привет мир" https://sms.ru/sms/cost\?api_id=[зарегистрируйтесь, чтобы получить api_id]\&to=79255070602
```

--------------------------------

### GET https://sms.ru/callback/get

Source: https://sms.ru/api/callback_get

Retrieves the list of registered callback URLs for the authenticated user.

```APIDOC
## GET https://sms.ru/callback/get

### Description
Retrieves a list of callback URLs registered for the account.

### Method
GET

### Endpoint
https://sms.ru/callback/get

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.

### Response
#### Success Response (200)
- **status** (string) - Status of the request (e.g., "OK").
- **status_code** (integer) - Numeric status code.
- **status_text** (string) - Descriptive status message.
- **callback** (array) - List of registered callback URLs.
```

--------------------------------

### GET /my/balance

Source: https://sms.ru/api/balance

Retrieves the current account balance for the authenticated user.

```APIDOC
## GET /my/balance

### Description
Retrieves the current account balance associated with the provided api_id.

### Method
GET

### Endpoint
https://sms.ru/my/balance

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **json** (integer) - Optional - Set to 1 to receive a structured JSON response.
```

--------------------------------

### GET /my/balance

Source: https://sms.ru/api/balance

Retrieves the current account balance for the authenticated user.

```APIDOC
## GET /my/balance

### Description
Retrieves the current account balance for the authenticated user.

### Method
GET

### Endpoint
https://sms.ru/my/balance

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API key.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
- **login** (string) - Required (if api_id not used) - Your phone number login.
- **password** (string) - Required (if api_id not used) - Your account password.

### Response
#### Success Response (200)
- **status** (string) - Status message (e.g., "OK").
- **status_code** (integer) - Success code (e.g., 100).
- **balance** (float) - Current account balance.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "balance": 4762.58
}
```

--------------------------------

### Add to stoplist using file_get_contents in PHP

Source: https://sms.ru/api/stoplist_add

Uses file_get_contents to perform a GET request to the stoplist/add endpoint.

```php
$body = file_get_contents("https://sms.ru/stoplist/add?api_id=[зарегистрируйтесь, чтобы получить api_id]&stoplist_phone=[номер телефона]&stoplist_text=".urlencode("[причина]")."&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### GET /auth/check

Source: https://sms.ru/api/auth_check

Verifies the validity of authentication credentials (api_id or login/password).

```APIDOC
## GET /auth/check

### Description
Verifies if the provided api_id or login/password pair is valid and active.

### Method
GET

### Endpoint
https://sms.ru/auth/check

### Parameters
#### Query Parameters
- **api_id** (string) - Required (if not using login/password) - Unique API key.
- **login** (string) - Required (if not using api_id) - User phone number.
- **password** (string) - Required (if not using api_id) - User password.
- **json** (integer) - Optional - Set to 1 to receive a JSON response.

### Request Example
https://sms.ru/auth/check?api_id=your_api_id&json=1

### Response
#### Success Response (200)
- **status** (string) - Status message (e.g., "OK").
- **status_code** (integer) - Status code (e.g., 100).

#### Response Example
{
    "status": "OK",
    "status_code": 100
}
```

--------------------------------

### GET https://sms.ru/stoplist/get

Source: https://sms.ru/api/stoplist_get

Получение списка номеров из стоплиста.

```APIDOC
## GET https://sms.ru/stoplist/get

### Description
Возвращает список номеров, которые были внесены пользователем в стоплист.

### Method
GET

### Endpoint
https://sms.ru/stoplist/get

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Ваш уникальный ключ авторизации.
- **login** (string) - Required (alternative) - Ваш номер телефона (логин).
- **password** (string) - Required (alternative) - Ваш пароль.
- **json** (integer) - Optional - Установите 1 для получения ответа в формате JSON.

### Request Example
https://sms.ru/stoplist/get?api_id=[api_id]&json=1

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **status_code** (integer) - Код выполнения.
- **stoplist** (object) - Список номеров и примечаний.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "stoplist": {
        "79680000001": "примечание"
    }
}
```

--------------------------------

### Initiate Call Check with file_get_contents in PHP

Source: https://sms.ru/api/call

Uses file_get_contents to perform a simple GET request to the SMS.ru API. Suitable for environments where cURL is not available.

```php
$body = file_get_contents("https://sms.ru/callcheck/add?api_id=[зарегистрируйтесь, чтобы получить api_id]&phone=79255070602&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### GET /callcheck/add

Source: https://sms.ru/api/call

Initiates a call verification request by adding a phone number to the database for confirmation.

```APIDOC
## GET /callcheck/add

### Description
Adds a phone number to the database to initiate the call verification process.

### Method
GET

### Endpoint
https://sms.ru/callcheck/add

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **phone** (string) - Required - The phone number to be verified.
- **json** (integer) - Optional - Set to 1 to receive a JSON response.

### Response
#### Success Response (100)
- **100** (integer) - Request successful, number added to database, awaiting call.

#### Error Responses
- **202** (integer) - Invalid phone number format.
- **400** (integer) - Number not yet confirmed.
- **401** (integer) - Number confirmed.
- **402** (integer) - Verification time expired or invalid check_id.
```

--------------------------------

### GET /callback/add

Source: https://sms.ru/api/callback_add

Registers a new callback URL to receive SMS status updates.

```APIDOC
## GET /callback/add

### Description
Adds a URL to the system that will receive status updates for sent SMS messages.

### Method
GET

### Endpoint
https://sms.ru/callback/add

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **url** (string) - Required - The URL on your side to receive callbacks (must be URL-encoded).
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.

### Request Example
https://sms.ru/callback/add?api_id=[your_api_id]&url=https%3A%2F%2Fyoursite.ru%2Fcallback.php&json=1

### Response
#### Success Response (200)
- **status** (string) - Status message (e.g., "OK").
- **status_code** (integer) - Execution status code (e.g., 100).
- **callback** (array) - List of currently registered callback URLs.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "callback": [
        "https://yoursite.ru/callback.php",
        "https://anothersite.ru/callback/index.php"
    ]
}
```

--------------------------------

### Add Callback via PHP file_get_contents

Source: https://sms.ru/api/callback_add

Uses file_get_contents to perform a GET request to the callback/add endpoint. Requires a valid api_id and URL encoding for the callback target.

```php
$body = file_get_contents("https://sms.ru/callback/add?api_id=[зарегистрируйтесь, чтобы получить api_id]&url=".urlencode("https://yoursite.ru/callback.php")."&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### GET /stoplist/add

Source: https://sms.ru/api/stoplist_add

Adds a phone number to the stoplist with an optional reason.

```APIDOC
## GET /stoplist/add

### Description
Adds a phone number to the stoplist to prevent future SMS delivery.

### Method
GET

### Endpoint
https://sms.ru/stoplist/add

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API key.
- **stoplist_phone** (string) - Required - The phone number to add to the stoplist.
- **stoplist_text** (string) - Required - The reason or note for adding the number.
- **json** (integer) - Optional - Set to 1 to receive a JSON response.

### Request Example
https://sms.ru/stoplist/add?api_id=[api_id]&stoplist_phone=[phone]&stoplist_text=[reason]&json=1

### Response
#### Success Response (200)
- **status** (string) - Status message (e.g., "OK").
- **status_code** (integer) - Success code (e.g., 100).

#### Response Example
{
    "status": "OK",
    "status_code": 100
}
```

--------------------------------

### Retrieve callbacks using PHP file_get_contents

Source: https://sms.ru/api/callback_get

Performs a simple GET request to the API endpoint. Suitable for environments where cURL is not available.

```php
$body = file_get_contents("https://sms.ru/callback/get?api_id=[зарегистрируйтесь, чтобы получить api_id]&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### GET /stoplist/get

Source: https://sms.ru/api/stoplist_get

Retrieves the list of phone numbers currently in the stoplist.

```APIDOC
## GET /stoplist/get

### Description
Retrieves the list of phone numbers currently in the stoplist.

### Method
GET

### Endpoint
https://sms.ru/stoplist/get

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
```

--------------------------------

### GET /callcheck/add

Source: https://sms.ru/api/call

Initiates a call-based authorization request for a specific phone number.

```APIDOC
## GET /callcheck/add

### Description
Initiates the call authorization process by providing the user's phone number. The system returns a phone number that the user must call to complete the authorization.

### Method
GET

### Endpoint
https://sms.ru/callcheck/add

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API key.
- **phone** (string) - Required - The user's phone number to authorize.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.

### Response
#### Success Response (200)
- **status** (string) - Request execution status.
- **status_code** (integer) - Success code.
- **check_id** (string) - Authorization identifier.
- **call_phone** (string) - The phone number the user must call.
- **call_phone_pretty** (string) - Formatted phone number for display.
- **call_phone_html** (string) - HTML link for mobile devices.

### Response Example
{
    "status": "OK",
    "status_code": 100,
    "check_id": "201737-542",
    "call_phone": "78005008275",
    "call_phone_pretty": "+7 (800) 500-8275",
    "call_phone_html": "<a href=\"callto:78005008275\">+7 (800) 500-8275<\a>"
}
```

--------------------------------

### Check SMS status with curl

Source: https://sms.ru/api/status

Command-line example for checking status. Note that Windows users should remove the backslashes before special characters.

```bash
curl https://sms.ru/sms/send\?api_id=[зарегистрируйтесь, чтобы получить api_id]\&sms_id=000000-000001,000000-000002,000000-000003
```

--------------------------------

### Retrieve balance using PHP file_get_contents

Source: https://sms.ru/api/balance

Performs a simple GET request to the balance endpoint without requiring the cURL extension.

```php
$body = file_get_contents("https://sms.ru/my/balance?api_id=[зарегистрируйтесь, чтобы получить api_id]&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### Check SMS status with PHP

Source: https://sms.ru/api/status

Example implementation using cURL to request SMS status and parse the JSON response.

```php
$ch = curl_init("https://sms.ru/sms/status");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_POSTFIELDS, array(
    "api_id" => "[зарегистрируйтесь, чтобы получить api_id]",
    "sms_id" => "000000-000001,000000-000002,000000-000003", // До 100 штук за раз
    "json" => 1 // Для получения более развернутого ответа от сервера
));
$body = curl_exec($ch);
curl_close($ch);

$json = json_decode($body);
if ($json) { // Получен ответ от сервера
    print_r($json); // Для дебага
    if ($json->status == "OK") { // Запрос выполнился
        foreach ($json->sms as $sms_id => $data) { // Перебираем массив сообщений
            if ($data->status == "OK") { // Статус сообщения получен
                echo "ID сообщения: $sms_id ";
                echo "Код статуса сообщения: $data->status_code ";
                echo "Текст статуса сообщения: $data->status_text ";
                echo "Стоимость сообщения: $data->cost ";
                echo "";
            } else { // Ошибка в получении статуса
                echo "ID сообщения: $sms_id ";
                echo "Код ошибки: $data->status_code ";
                echo "Текст ошибки: $data->status_text ";
                echo "";
            }
        }
    } else { // Запрос не выполнился (возможно ошибка авторизации, параметрах, итд...)
        // Код ошибки: $json->status_code
        // Текст ошибки: $json->status_text
    }
} else { // Запрос не выполнился Не удалось установить связь с сервером

}
```

--------------------------------

### GET /sms/status

Source: https://sms.ru/api/status

Запрос статуса отправленных сообщений по их уникальным идентификаторам.

```APIDOC
## GET /sms/status

### Description
Позволяет вручную проверить статус отправленных сообщений, используя их sms_id.

### Method
GET

### Endpoint
/sms/status

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Ваш уникальный идентификатор API.
- **sms_id** (string) - Required - Идентификаторы сообщений, разделенные запятыми.
- **json** (integer) - Optional - Установите 1 для получения ответа в формате JSON.

### Request Example
https://sms.ru/sms/status?api_id=[api_id]&sms_id=000000-000001,000000-000002&json=1

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **status_code** (integer) - Код выполнения.
- **sms** (object) - Объект с результатами по каждому sms_id.
- **balance** (float) - Текущий баланс.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "sms": {
        "000000-000001": {
            "status": "OK",
            "status_code": 103,
            "cost": 0.50,
            "status_text": "Сообщение доставлено"
        }
    },
    "balance": 4122.56
}
```

--------------------------------

### Retrieve Stoplist using PHP file_get_contents

Source: https://sms.ru/api/stoplist_get

A simplified approach using file_get_contents to perform a GET request. Suitable for basic implementations where cURL is unavailable.

```php
$body = file_get_contents("https://sms.ru/stoplist/get?api_id=[зарегистрируйтесь, чтобы получить api_id]&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### Check API limits with PHP file_get_contents

Source: https://sms.ru/api/limit

Uses file_get_contents to perform a GET request. Suitable for environments where cURL is unavailable.

```php
$body = file_get_contents("https://sms.ru/my/limit?api_id=[зарегистрируйтесь, чтобы получить api_id]&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### GET https://sms.ru/my/limit

Source: https://sms.ru/api/limit

Запрос для получения информации о дневном лимите и его использовании.

```APIDOC
## GET https://sms.ru/my/limit

### Description
Возвращает информацию о дневном лимите на отправку сообщений и количестве номеров, на которые уже были отправлены сообщения сегодня.

### Method
GET

### Endpoint
https://sms.ru/my/limit

### Parameters
#### Query Parameters
- **api_id** (string) - Обязательный - Уникальный ключ авторизации.
- **login** (string) - Обязательный (если не используется api_id) - Ваш номер телефона (логин).
- **password** (string) - Обязательный (если не используется api_id) - Ваш пароль.
- **json** (integer) - Опционально - Установите 1 для получения ответа в формате JSON.

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса (например, "OK").
- **status_code** (integer) - Код выполнения (например, 100).
- **total_limit** (integer) - Общий дневной лимит.
- **used_today** (integer) - Количество использованных лимитов сегодня.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "total_limit": 100,
    "used_today": 7
}
```

--------------------------------

### GET https://sms.ru/my/free

Source: https://sms.ru/api/my_free

Retrieves the total number of free messages available and the count of messages used today.

```APIDOC
## GET https://sms.ru/my/free

### Description
Returns information about the daily limit of free messages and current usage for the authenticated account.

### Method
GET

### Endpoint
https://sms.ru/my/free

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Unique API key for authentication.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
- **login** (string) - Required (if api_id not used) - Phone number login.
- **password** (string) - Required (if api_id not used) - Account password.

### Response
#### Success Response (200)
- **status** (string) - Request execution status (e.g., "OK").
- **status_code** (integer) - Numeric status code (e.g., 100).
- **total_free** (integer) - Total free messages available.
- **used_today** (integer) - Number of free messages used today.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "total_free": 5,
    "used_today": 3
}
```

--------------------------------

### Retrieve senders using PHP file_get_contents

Source: https://sms.ru/api/senders

A simplified approach using file_get_contents to perform a GET request to the API endpoint.

```php
$body = file_get_contents("https://sms.ru/my/senders?api_id=[зарегистрируйтесь, чтобы получить api_id]&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### Delete from stoplist using PHP file_get_contents

Source: https://sms.ru/api/stoplist_del

Performs a GET request to the stoplist deletion endpoint without requiring the cURL extension.

```php
$body = file_get_contents("https://sms.ru/stoplist/del?api_id=[зарегистрируйтесь, чтобы получить api_id]&stoplist_phone=[номер телефона]&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### Delete callback URL using PHP file_get_contents

Source: https://sms.ru/api/callback_del

Performs a GET request to the deletion endpoint without requiring the cURL extension.

```php
$body = file_get_contents("https://sms.ru/callback/del?api_id=[зарегистрируйтесь, чтобы получить api_id]&url=".urlencode("http://yoursite.ru/callback.php")."&json=1"); 

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### GET /stoplist/del

Source: https://sms.ru/api/stoplist_del

Removes a phone number from the stoplist.

```APIDOC
## GET /stoplist/del

### Description
Removes a phone number from the stoplist.

### Method
GET

### Endpoint
https://sms.ru/stoplist/del

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API key.
- **stoplist_phone** (string) - Required - The phone number to remove from the stoplist.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
- **login** (string) - Optional - Alternative authentication: your phone number.
- **password** (string) - Optional - Alternative authentication: your password.

### Response
#### Success Response (200)
- **status** (string) - Status message (e.g., "OK").
- **status_code** (integer) - Success code (e.g., 100).

#### Response Example
{
    "status": "OK",
    "status_code": 100
}
```

--------------------------------

### GET /callcheck/status

Source: https://sms.ru/api/call

Retrieves the status of a call verification request.

```APIDOC
## GET /callcheck/status

### Description
Checks the status of a call verification using the provided check identifier.

### Method
GET

### Endpoint
https://sms.ru/callcheck/status

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API key.
- **check_id** (string) - Required - The authorization identifier received from the initial call request.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.

### Response
#### Success Response (200)
- **status** (string) - Request execution status.
- **status_code** (integer) - Success code.
- **check_status** (string) - Authorization status code.
- **check_status_text** (string) - Textual description of the authorization status.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "check_status": "401",
    "check_status_text": "Авторизация по звонку: номер подтвержден"
}
```

--------------------------------

### GET /sms/send

Source: https://sms.ru/api/send

Sends an SMS message to a specified recipient.

```APIDOC
## GET /sms/send

### Description
Sends an SMS message to a specified phone number.

### Method
GET

### Endpoint
https://sms.ru/sms/send

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your API identifier.
- **to** (string) - Required - Recipient phone number.
- **msg** (string) - Required - The message text to send.
- **json** (integer) - Optional - Set to 1 to receive response in JSON format.
```

--------------------------------

### Initiate call verification with curl

Source: https://sms.ru/api/call

Use this command to add a phone number to the verification database. On Windows, remove the backslash characters before the question mark and ampersand.

```bash
curl https://sms.ru/callcheck/add\api_id=[зарегистрируйтесь, чтобы получить api_id]\phone=79255070602\json=1
```

--------------------------------

### Запрос на добавление callback URL

Source: https://sms.ru/api/callback_add

Используйте этот URL для регистрации обработчика статусов. Обязательно замените api_id на ваш уникальный идентификатор и закодируйте URL обработчика.

```http
https://sms.ru/callback/add?api_id=[зарегистрируйтесь, чтобы получить api_id]&url=https%3A%2F%2Fyoursite.ru%2Fcallback.php&json=1
```

--------------------------------

### GET /callback/del

Source: https://sms.ru/api/callback_del

Removes a registered webhook handler URL.

```APIDOC
## GET /callback/del

### Description
Removes a previously registered webhook handler.

### Method
GET

### Endpoint
https://sms.ru/callback/del

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API key.
- **url** (string) - Required - The URL of the handler to remove (must start with http://). Must be URL-encoded if sent via GET.
- **json** (integer) - Optional - Set to 1 to receive a JSON response.
- **login** (string) - Optional - Alternative authentication: phone number.
- **password** (string) - Optional - Alternative authentication: password.

### Response
#### Success Response (200)
- **status** (string) - Status message (e.g., "OK").
- **status_code** (integer) - Success code (100).
- **callback** (array) - List of remaining callback URLs.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "callback": [
        "http://yoursite.ru/callback.php",
        "http://anothersite.ru/callback/index.php"
    ]
}
```

--------------------------------

### GET /sms/status

Source: https://sms.ru/api/status

Retrieves the status of one or more SMS messages by their IDs.

```APIDOC
## GET /sms/status

### Description
Retrieves the delivery status of SMS messages using their unique identifiers.

### Method
GET

### Endpoint
https://sms.ru/sms/status

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **sms_id** (string) - Required - Comma-separated list of SMS IDs to check.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
```

--------------------------------

### Retrieve callbacks using cURL command line

Source: https://sms.ru/api/callback_get

Direct command-line execution for the API. Note that Windows users should remove the backslashes before special characters.

```bash
curl -d https://sms.ru/callback/get\?api_id=[зарегистрируйтесь, чтобы получить api_id]\&json=1
```

--------------------------------

### POST /auth/check

Source: https://sms.ru/api/auth_check

Verifies authentication credentials and returns account status.

```APIDOC
## POST /auth/check

### Description
Verifies the provided authentication credentials (api_id or login/password) and returns the account status and balance.

### Method
POST

### Endpoint
https://sms.ru/auth/check

### Parameters
#### Request Body
- **api_id** (string) - Optional - Your API identifier.
- **login** (string) - Optional - Your account login.
- **password** (string) - Optional - Your account password.
- **json** (integer) - Optional - Set to 1 to receive a detailed JSON response.

### Response
#### Success Response (200)
- **status** (string) - Status of the request (e.g., "OK").
- **balance** (float) - Current account balance.
- **status_code** (integer) - Status code of the operation.
- **status_text** (string) - Descriptive text for the status code.
```

--------------------------------

### Check authentication status with curl

Source: https://sms.ru/api/auth_check

Use this command to verify your API credentials. On Windows, remove the backslash before the question mark and ampersand characters.

```bash
curl https://sms.ru/auth/check\?api_id=[зарегистрируйтесь, чтобы получить api_id]
```

--------------------------------

### SMTP Server Configuration Settings

Source: https://sms.ru/api/smtp

Required connection parameters for configuring SMTP-capable software to communicate with the SMS.ru gateway.

```text
SMTP сервер: sms.ru
Логин: 79255070602
Пароль: ваш пароль от нашего сервиса
Порт: 465 (SSL) или 587 (TLS)
```

--------------------------------

### GET https://sms.ru/sms/status

Source: https://sms.ru/api/status

Retrieves the status of one or more SMS messages by their IDs.

```APIDOC
## POST https://sms.ru/sms/status

### Description
Retrieves the status of sent SMS messages using their unique identifiers. You can request statuses for up to 100 messages in a single request.

### Method
POST

### Endpoint
https://sms.ru/sms/status

### Parameters
#### Query/Body Parameters
- **api_id** (string) - Required - Your unique API key for authentication.
- **sms_id** (string) - Required - Identifier(s) of the message(s), separated by commas.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format with detailed information.
- **login** (string) - Optional - Alternative authentication via phone number.
- **password** (string) - Optional - Alternative authentication via password.

### Response
#### Success Response (200)
- **status** (string) - Request execution status (e.g., "OK").
- **sms** (object) - Map of sms_id to status data including status_code, status_text, and cost.
```

--------------------------------

### Retrieve balance using command-line cURL

Source: https://sms.ru/api/balance

Direct command-line request to the balance endpoint. Note that Windows users may need to remove backslashes before special characters.

```bash
curl https://sms.ru/my/balance\?api_id=[зарегистрируйтесь, чтобы получить api_id]
```

--------------------------------

### GET /my/senders

Source: https://sms.ru/api/senders

Retrieves a list of registered SMS senders for the authenticated user.

```APIDOC
## GET /my/senders

### Description
Retrieves the list of registered sender names available for the account.

### Method
GET

### Endpoint
https://sms.ru/my/senders

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **json** (integer) - Optional - Set to 1 to receive a structured JSON response.
```

--------------------------------

### Check API limits with command-line cURL

Source: https://sms.ru/api/limit

Direct command-line execution. Note that Windows environments may require removing backslashes before special characters.

```bash
curl https://sms.ru/my/limit\?api_id=[зарегистрируйтесь, чтобы получить api_id]
```

--------------------------------

### GET https://sms.ru/my/senders

Source: https://sms.ru/api/senders

Получение списка одобренных отправителей для аккаунта.

```APIDOC
## GET https://sms.ru/my/senders

### Description
Возвращает список отправителей, которые были согласованы пользователем на сайте SMS.RU.

### Method
GET

### Endpoint
https://sms.ru/my/senders

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Уникальный ключ авторизации пользователя.
- **json** (integer) - Optional - Установите в 1 для получения ответа в формате JSON.
- **login** (string) - Required (alternative) - Номер телефона (логин).
- **password** (string) - Required (alternative) - Пароль пользователя.

### Response
#### Success Response (200)
- **status** (string) - Статус выполнения запроса.
- **status_code** (integer) - Код выполнения.
- **senders** (array) - Список имен отправителей.

#### Response Example
{
    "status": "OK",
    "status_code": 100,
    "senders": [
        "sender1",
        "sender2"
    ]
}
```

--------------------------------

### Retrieve stoplist using curl

Source: https://sms.ru/api/stoplist_get

Use this command to fetch the stoplist. Note that on Windows, the backslash before special characters like ? and & should be removed.

```bash
curl https://sms.ru/stoplist/get\?api_id=[зарегистрируйтесь, чтобы получить api_id]
```

--------------------------------

### Отправка СМС на Perl

Source: https://sms.ru/api/send

Использует модуль LWP::UserAgent для выполнения POST-запроса к API.

```perl
#!/usr/bin/perl
use LWP::Simple;
use HTTP::Request::Common qw(POST);

$ua = LWP::UserAgent->new;
my $req = POST 'https://sms.ru/sms/send',
[
api_id => '[зарегистрируйтесь, чтобы получить api_id]',
to => '79255070602',
msg => 'hello world'
];
print $ua->request($req)->as_string;
```

--------------------------------

### GET /sms/cost

Source: https://sms.ru/api/cost

Calculates the cost of an SMS message based on the recipient and message content.

```APIDOC
## GET /sms/cost

### Description
Calculates the cost of sending an SMS message to a specified phone number.

### Method
GET

### Endpoint
https://sms.ru/sms/cost

### Parameters
#### Query Parameters
- **api_id** (string) - Required - Your API identifier.
- **to** (string) - Required - The recipient's phone number.
- **msg** (string) - Required - The text content of the message.
- **json** (integer) - Optional - Set to 1 to receive the response in JSON format.
```

--------------------------------

### Check SMS status with PHP

Source: https://sms.ru/api/status

Uses file_get_contents to fetch status data. Recommended to use the official library instead of this manual implementation.

```php
$body = file_get_contents("https://sms.ru/sms/status?api_id=[зарегистрируйтесь, чтобы получить api_id]&sms_id=000000-000001,000000-000002,000000-000003&json=1");

$json = json_decode($body);
print_r($json); // Для дебага
// Для разбора $json можно использовать кусок кода из предыдущего примера.
```

--------------------------------

### Запрос информации о лимитах

Source: https://sms.ru/api/limit

Выполните GET-запрос по указанному URL для получения данных о лимитах. Требуется наличие api_id, полученного в личном кабинете.

```http
https://sms.ru/my/limit?api_id=[зарегистрируйтесь, чтобы получить api_id]&json=1
```

--------------------------------

### GET /my/limit

Source: https://sms.ru/api/limit

Retrieves the current SMS sending limit and usage statistics for the authenticated account.

```APIDOC
## GET /my/limit

### Description
Retrieves the account's total SMS limit and the number of SMS messages sent today.

### Method
GET / POST

### Endpoint
https://sms.ru/my/limit

### Parameters
#### Query/Body Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **json** (integer) - Optional - Set to 1 to receive a structured JSON response.

### Response
#### Success Response (200)
- **status** (string) - Status of the request (e.g., "OK").
- **total_limit** (integer) - The total daily SMS limit for the account.
- **used_today** (integer) - The number of SMS messages sent today.

#### Error Response
- **status_code** (integer) - The error code returned by the server.
- **status_text** (string) - A description of the error encountered.
```

--------------------------------

### POST https://sms.ru/stoplist/add

Source: https://sms.ru/api/stoplist_add

Adds a phone number to the stoplist. Can be called via POST or GET.

```APIDOC
## POST https://sms.ru/stoplist/add

### Description
Adds a phone number to the stoplist to prevent future SMS delivery to that number.

### Method
POST (or GET)

### Endpoint
https://sms.ru/stoplist/add

### Parameters
#### Request Body / Query Parameters
- **api_id** (string) - Required - Your unique API identifier.
- **stoplist_phone** (string) - Required - The phone number to add to the stoplist.
- **stoplist_text** (string) - Optional - A note or reason for adding the number.
- **json** (integer) - Optional - Set to 1 to receive a structured JSON response.

### Response
#### Success Response (200)
- **status** (string) - Indicates the result of the request (e.g., "OK").
- **status_code** (integer) - The status code of the operation.
- **status_text** (string) - A descriptive message regarding the operation status.
```
Tokens:
Raw