Для AI-агентов: markdown этой страницы — /docs-content/workday/work-reports/list.md индекс документации — /llms.txt

Список рабочих отчётов

GET /v1/workday/work-reports

Возвращает рабочие отчёты сотрудника с отбором по периоду и постраничной выдачей.

Требуется скоуп timeman. Битрикс24 проверяет права владельца учётных данных. Ключ READONLY может читать отчёты, запись запрещена.

Параметры

Параметр	Тип	Обяз.	По умолч.	Описание
`userId` (query)	integer	да	—	ID сотрудника, чьи отчёты нужны. Список: `GET /v1/users`
`activeOnly` (query)	boolean	нет	—	`true` — только сданные отчёты
`dateFrom` (query)	string	нет	—	Начало периода в формате ISO 8601 с часовым поясом. В выдачу попадают отчёты, чей период пересекается с заданным, границы включаются
`dateTo` (query)	string	нет	—	Конец периода в том же формате
`limit` (query)	integer	нет	`50`	Сколько отчётов вернуть, от 1 до 50
`offset` (query)	integer	нет	`0`	Сколько отчётов пропустить. Нельзя передавать вместе с `page`
`page` (query)	integer	нет	`1`	Номер страницы размером `limit`. Нельзя передавать вместе с `offset`
`order` (query)	string	нет	`{"id":"desc"}`	Сортировка — JSON-объект с направлениями `asc` или `desc`, например `{"id":"asc"}`
`select` (query)	string	нет	—	Поля отчёта через запятую. Список — Поля отчёта

Примеры

curl — личный ключ

Terminal

curl "https://vibecode.bitrix24.tech/v1/workday/work-reports?userId=101" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal

curl "https://vibecode.bitrix24.tech/v1/workday/work-reports?userId=101" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/work-reports?userId=101', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const { data, meta } = await res.json()

JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/work-reports?userId=101', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data, meta } = await res.json()

Поля ответа

Поле	Тип	Описание
`success`	boolean	`true` при успешном запросе
`data`	array	Массив отчётов. Состав отчёта — Поля отчёта
`meta.limit`	integer	Размер страницы
`meta.offset`	integer	Сколько отчётов пропущено
`meta.hasMore`	boolean	`true`, когда на странице `limit` отчётов и за ней могут быть ещё

Пример ответа

Показаны основные поля отчёта. Полный список — Поля отчёта:

JSON

{
  "success": true,
  "data": [
    {
      "id": 145,
      "userId": 101,
      "active": false,
      "reportType": "day",
      "reportDate": "2026-10-06T18:33:06.000Z",
      "dateFrom": "2026-10-06T21:00:00.000Z",
      "dateTo": "2026-10-06T21:00:00.000Z",
      "report": "Sprint summary",
      "type": "REPORT",
      "mark": "N",
      "approve": "N"
    },
    {
      "id": 143,
      "userId": 101,
      "active": false,
      "reportType": "day",
      "reportDate": "2026-10-06T18:22:40.000Z",
      "dateFrom": "2026-10-05T21:00:00.000Z",
      "dateTo": "2026-10-05T21:00:00.000Z",
      "report": "Weekly report",
      "type": "REPORT",
      "mark": "N",
      "approve": "N"
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

Пример ответа при ошибке

400 — не передан userId: