метод REST scope: tasks

tasks.task.result.list

Получить список результатов задачи v 3.0

Кто может выполнять: любой пользователь с доступом к задаче

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод tasks.task.result.list возвращает список результатов задачи.

Параметры

order object необязательный

Объект для сортировки списка результатов в формате {"field_1": "value_1", ... "field_N": "value_N"}.

Направление сортировки может принимать значения:

  • ASC — по возрастанию
  • DESC — по убыванию

Поле для сортировки может принимать значения:
- id — идентификатор результата
- authorId — идентификатор автора результата
- createdAt — дата создания результата
- updatedAt — дата обновления результата
- status — статус результата
- messageId — идентификатор сообщения чата

filter array обязательный

Массив условий для фильтрации списка результатов. Обязательно передайте условие по taskId.

Каждое условие — массив с названием поля, оператором и значением. Для оператора = можно передать только название поля и значение.

Форматы условий:
- ["taskId", 51]
- ["id", ">=", 17]
- ["id", "in", [17, 18, 19]]

Доступные операторы фильтра: =, >, <, <=, >=, !=, in, between.

  • = — равно
  • > — больше
  • < — меньше
  • <= — меньше либо равно
  • >= — больше либо равно
  • != — не равно
  • in — входит в список значений
  • between — находится в диапазоне значений

Фильтруемое поле может принимать значения:
- taskId — идентификатор задачи. Обязательное поле
- id — идентификатор результата
- authorId — идентификатор автора результата
- status — статус результата. Возможные значения: open, closed
- messageId — идентификатор сообщения чата, из которого создан результат

select array необязательный

Массив полей, которые нужно выбрать.

Если параметр не передан, метод вернет поля по умолчанию.

Поле может принимать значения:
- id — идентификатор результата
- taskId — идентификатор задачи
- text — текст результата
- authorId — идентификатор автора результата
- author — данные автора
- createdAt — дата создания результата
- updatedAt — дата обновления результата
- status — статус результата
- fileIds — идентификаторы файлов результата
- rights — права текущего пользователя на результат
- messageId — идентификатор сообщения чата

pagination object необязательный

Объект для управления постраничной навигацией.

Параметры постраничной навигации:
- page — номер страницы
- limit — количество элементов на странице
- offset — смещение от начала списка

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"filter":[["taskId",51]],"select":["id","taskId","text","authorId","createdAt","status","messageId"],"order":{"createdAt":"DESC"},"pagination":{"limit":10,"offset":0}}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.result.list

Ответ

HTTP-статус: 200

{
    "result": {
        "items": [
            {
                "id": 17,
                "taskId": 51,
                "text": "Работа по задаче выполнена",
                "authorId": 1,
                "createdAt": "2026-04-30T10:15:00+03:00",
                "status": "open",
                "messageId": null
            }
        ]
    },
    "time": {
        "start": 1777529700,
        "finish": 1777529700.123456,
        "duration": 0.123456,
        "processing": 0.1,
        "date_start": "2026-04-30T10:15:00+03:00",
        "date_finish": "2026-04-30T10:15:00+03:00",
        "operating_reset_at": 1777530300,
        "operating": 0
    }
}

Возвращаемые данные

result object

Объект с данными ответа (подробное описание)

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "field": "filter",
                "message": "Значение поля не может быть пустым"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
filter Значение поля не может быть пустым Передайте фильтр в виде массива условий
taskId В поле taskId требуется тип данных int для такого запроса Передайте taskId как число

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.