# imopenlines.v2.Session.Rating.list
URL: https://chugunov.pro/api-bitrix24/imopenlines/statistics/imopenlines-v2-session-rating-list/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.
Получить список оценок
Scope: `imopenlines`
Кто может выполнять метод: пользователь с доступом к отчетам открытых линий
## Описание
Метод `imopenlines.v2.Session.Rating.list` получает список сессий, которым клиент поставил оценку.
## Параметры
- `dateVoteFrom` `string` — обязательный. Начало периода клиентской оценки в формате ISO 8601
- `dateVoteTo` `string` — обязательный. Конец периода клиентской оценки в формате ISO 8601.
Максимальный период: 366 дней
- `configId` `integer` — необязательный. Идентификатор открытой линии.
Идентификатор можно получить методом [imopenlines.config.list.get](https://chugunov.pro/api-bitrix24/imopenlines/openlines/imopenlines-config-list-get/)
- `configIdList` `integer[]` — необязательный. Список идентификаторов открытых линий.
Идентификаторы можно получить методом [imopenlines.config.list.get](https://chugunov.pro/api-bitrix24/imopenlines/openlines/imopenlines-config-list-get/).
Если переданы `configIdList` и `configId`, используется `configIdList`.
Максимум: 1000 элементов
- `operatorId` `integer` — необязательный. Идентификатор оператора.
Идентификатор можно получить методом [user.get](https://chugunov.pro/api-bitrix24/user/user-get/) или [user.search](https://chugunov.pro/api-bitrix24/user/user-search/)
- `operatorIdList` `integer[]` — необязательный. Список идентификаторов операторов.
Идентификаторы можно получить методом [user.get](https://chugunov.pro/api-bitrix24/user/user-get/) или [user.search](https://chugunov.pro/api-bitrix24/user/user-search/).
Если переданы `operatorIdList` и `operatorId`, используется `operatorIdList`.
Максимум: 1000 элементов
- `source` `string` — необязательный. Код канала.
Код можно получить методом [imconnector.list](https://chugunov.pro/api-bitrix24/imopenlines/imconnector/imconnector-list/)
- `sourceList` `string[]` — необязательный. Список кодов каналов.
Коды можно получить методом [imconnector.list](https://chugunov.pro/api-bitrix24/imopenlines/imconnector/imconnector-list/).
Если переданы `sourceList` и `source`, используется `sourceList`.
Максимум: 1000 элементов
- `vote` `string` — необязательный. Клиентская оценка.
Возможные значения:
- `like` — клиент поставил лайк
- `dislike` — клиент поставил дизлайк
- `hasVoteHead` `boolean` — необязательный. Фильтр по наличию оценки руководителя.
Возможные значения:
- `true`, `Y`, `1` — есть оценка руководителя
- `false`, `N`, `0` — оценки руководителя нет
- `offset` `integer` — необязательный. Смещение для пагинации.
По умолчанию: `0`
- `limit` `integer` — необязательный. Размер страницы.
Возможные значения: от `1` до `200`.
По умолчанию: `50`
## Ответ
HTTP-статус: 200
```json
{
"result": {
"ratings": [
{
"sessionId": 1024,
"configId": 3,
"operatorId": 42,
"source": "livechat",
"vote": "like",
"voteHead": 5,
"commentHead": "Хорошая работа",
"dateVote": "2026-06-15T14:53:00+03:00",
"dateSessionClose": "2026-06-15T14:52:10+03:00"
}
],
"hasNextPage": false
},
"time": {
"start": 1782810000,
"finish": 1782810000.2,
"duration": 0.2,
"processing": 0,
"date_start": "2026-06-30T10:00:00+03:00",
"date_finish": "2026-06-30T10:00:00+03:00",
"operating_reset_at": 1782810600,
"operating": 0
}
}
```
### Возвращаемые данные
- `result` `object`. Корневой объект ответа
- `result.ratings` `rating[]`. Список сессий с клиентской оценкой.
Все поля типа [`rating`](https://apidocs.bitrix24.ru/api-reference/imopenlines/statistics/data-types.html#rating) смотрите в разделе [Типы данных статистики открытых линий](https://apidocs.bitrix24.ru/api-reference/imopenlines/statistics/data-types.html#rating)
- `result.hasNextPage` `boolean`. Признак следующей страницы
- `time` `time`. Информация о времени выполнения запроса
## Ошибки
HTTP-статус: 400
```json
{
"error": "INVALID_FILTER",
"error_description": "Invalid vote filter value"
}
```
- `400` — `TARIFF_RESTRICTION`. Statistics reports are not available on the current tariff plan
- `400` — `PERIOD_REQUIRED`. dateVoteFrom and dateVoteTo are required
- `400` — `INVALID_FILTER`. Invalid filter value
- `400` — `PERIOD_TOO_LARGE`. The requested period exceeds the maximum of 1 year
- `400` — `OFFSET_TOO_LARGE`. Offset is too large
## Примеры запроса
### cURL (Webhook)
```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"configId": 3,
"vote": "like",
"dateVoteFrom": "2026-06-01T00:00:00+03:00",
"dateVoteTo": "2026-06-30T23:59:59+03:00"
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/imopenlines.v2.Session.Rating.list
```
### cURL (OAuth)
```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"configId": 3,
"vote": "like",
"dateVoteFrom": "2026-06-01T00:00:00+03:00",
"dateVoteTo": "2026-06-30T23:59:59+03:00",
"auth": "**put_access_token_here**"
}' \
https://**put_your_bitrix24_address**/rest/imopenlines.v2.Session.Rating.list
```
### JS (TS)
```ts
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make({
method: 'imopenlines.v2.Session.Rating.list',
params: {
configId: 3,
vote: 'like',
dateVoteFrom: '2026-06-01T00:00:00+03:00',
dateVoteTo: '2026-06-30T23:59:59+03:00',
},
requestId: Text.getUuidRfc4122()
})
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
console.info(response.getData()!.result.ratings)
}
} catch (error) {
console.error(error)
}
```
### JS (UMD)
```html
```
### Python
```python
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.call(
"imopenlines.v2.Session.Rating.list",
{
"configId": 3,
"vote": "like",
"dateVoteFrom": "2026-06-01T00:00:00+03:00",
"dateVoteTo": "2026-06-30T23:59:59+03:00",
},
).response
print(bitrix_response.result)
except BitrixAPIError as error:
print(f"error: {error.error}", f"error_description: {error.error_description}", sep="\n")
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
```
### PHP
```php
try {
$response = $b24Service
->core
->call(
'imopenlines.v2.Session.Rating.list',
[
'configId' => 3,
'vote' => 'like',
'dateVoteFrom' => '2026-06-01T00:00:00+03:00',
'dateVoteTo' => '2026-06-30T23:59:59+03:00',
]
);
print_r($response->getResponseData()->getResult());
} catch (Throwable $e) {
echo $e->getMessage();
}
```
### BX24.js
```js
BX24.callMethod(
'imopenlines.v2.Session.Rating.list',
{
configId: 3,
vote: 'like',
dateVoteFrom: '2026-06-01T00:00:00+03:00',
dateVoteTo: '2026-06-30T23:59:59+03:00',
},
function(result)
{
if (result.error())
{
console.error(result.error());
}
else
{
console.log(result.data());
}
}
);
```
### PHP CRest
```php
require_once('crest.php');
$result = CRest::call(
'imopenlines.v2.Session.Rating.list',
[
'configId' => 3,
'vote' => 'like',
'dateVoteFrom' => '2026-06-01T00:00:00+03:00',
'dateVoteTo' => '2026-06-30T23:59:59+03:00',
]
);
print_r($result);
```
### Go
```go
res, err := client.Core().Call(ctx, "imopenlines.v2.Session.Rating.list", b24.Params{
"configId": 3,
"vote": "like",
"dateVoteFrom": "2026-06-01T00:00:00+03:00",
"dateVoteTo": "2026-06-30T23:59:59+03:00",
}, b24.WithIdempotent())
if err != nil {
return fmt.Errorf("imopenlines.v2.Session.Rating.list: %w", err)
}
fmt.Println(string(res.Result))
```
Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/imopenlines/statistics/imopenlines-v2-session-rating-list.html