---
title: "Получить обсуждение документа"
method: GET
path: "/api/v1/docflow/comments"
tags: ["Docflow flow"]
---

# Получить обсуждение документа

`GET /api/v1/docflow/comments`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/docflow/comments`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Лента комментариев модуля docflow (документы) у предмета: карточки документооборота (subject_kind=flow_document) или заявки на оплату (subject_kind=payment_request), старые сверху. Ленту видит тот, кто видит сам предмет: карточку — правом docflow.flow:read в области её юрлица и по правилу записей роли, заявку — автор, его круг и docflow.flow:read или docflow.flow:approve, любой предмет — участник его согласования. Предмет не виден или не существует — 404. Удалённый комментарий остаётся в ленте следом: deleted=true, без текста. can_edit и can_delete считаются для смотрящего: свой комментарий правят 15 минут (editable_until), удаляют в любой момент. Ничего не пишет.

## Query parameters

- `subject_kind` 'flow_document' | 'payment_request', required
- `subject_id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Лента комментариев

- DocflowDocumentCommentList
  - `results` DocflowDocumentComment[], required
    - `id` string, uuid, required
    - `subject_kind` 'flow_document' | 'payment_request', required: Вид предмета
    - `subject_id` string, uuid, required
    - `author_id` integer, required: Автор комментария
    - `author_name` string, required: Имя автора
    - `body` string, required: Текст; пусто у удалённого
    - `mentions` DocflowDocumentCommentMention[], required
      - `user_id` integer, required: Упомянутый сотрудник
      - `name` string, required: Имя на момент упоминания
      - `sees_document` boolean, required: Видел ли документ, когда его упомянули; false — уведомление не ушло
    - `created_at` string, date-time, required
    - `edited_at` string, date-time: Когда текст исправили
    - `deleted_at` string, date-time: Когда комментарий удалили
    - `deleted` boolean, required: Комментарий удалён — остался след
    - `can_edit` boolean, required: Смотрящий вправе исправить: свой и не прошло 15 минут
    - `editable_until` string, date-time: До какого времени свой комментарий можно исправить
    - `can_delete` boolean, required: Смотрящий вправе удалить — свой комментарий

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `503`: Внешний банк, справочник или контур подключений временно недоступен

## Changes

- **2026-10-20** `765c65fadf8f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akeda/apis/akeda-erp-client-api/changes/api/v1/docflow/comments/get.md)

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/7a6b75f272ee?raw)