---
title: "Получить список задач"
method: GET
path: "/api-v2/task-list"
tags: ["Задачи"]
---

# Получить список задач

`GET /api-v2/task-list`

## Request

- Base URL: `https://api-docs.yougile.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.yougile.com/api-v2/task-list`
- Auth: HTTP bearer

## Query parameters

- `includeDeleted` boolean
- `limit` number
- `offset` number
- `title` string
- `columnId` string
- `assignedTo` string
- `stickerId` string
- `stickerStateId` string

## Response `200`

- TaskListDto
  - `paging` PagingMetadata, required
    - `count` number, required: Количество элементов в результате
    - `limit` number, required: Количество элементов на страницу
    - `offset` number, required: Индекс первого элемента страницы
    - `next` boolean, required: Есть ли элементы после данной страницы
  - `content` TaskListDtoBase[], required: Список задач
    - `id` string, required: ID объекта
    - `deleted` boolean: Если true, значит объект удален
    - `title` string, required: Название задачи
    - `timestamp` number, required: Время создания задачи
    - `columnId` string: Id колонки родителя
    - `description` string: Описание задачи
    - `archived` boolean: Задача перенесена в архив - да/нет
    - `archivedTimestamp` number: Время, когда задача перенесена в архив
    - `completed` boolean: Задача выполнена - да/нет
    - `completedTimestamp` number: Время, когда задача выполнена
    - `subtasks` string[]: Массив Id подзадач
    - `assigned` string[]: Массив Id пользователей, на которых назначена задача
    - `createdBy` string: Id пользователя, который создал задачу
    - `deadline` Deadline
      - `deadline` number, required: Timestamp дэдлайна
      - `startDate` number: Timestamp начала задачи
      - `withTime` boolean: Отображать на стикере время, или только дату
      - `history` string[]: История изменений дедлайна
      - `blockedPoints` string[], required: Точки, которые блокируют дату дедлайна (Начало или Конец)
      - `links` string[], required: Связанные задачи
    - `timeTracking` TimeTracking
      - `plan` number, required: Сколько часов было запланировано на выполнение задачи
      - `work` number, required: Сколько часов было затрачено на выполнение задачи
    - `checklists` CheckList[]: Чеклисты. К задаче всегда будет присвоен переданный объект. Если необходимо внести изменения, нужно сначала получить чеклисты, затем произвести корректировку, а затем записать в задачу заново.
      - `title` string, required: Название списка чеклистов
      - `items` CheckListItem, required
        - `title` string, required: Название чеклиста
        - `isCompleted` boolean, required: Выполненность чеклиста
    - `stickers` object: Пользовательские стикеры. Передаются в виде объекта ключ-значение, где ключ — ID стикера, значение — ID состояния для стикеров с состоянием или строка со значением для стикеров свободных полей.<br /> Для открепления стикера от задачи, используйте "-" как значение состояния.<br /> Для прикрепления пустого стикера (без состояния), используйте "empty" как значение состояния.<br /> Для стикеров типа "свободное текстовое поле" передавайте произвольную строку, например "ООО «Производство»".<br /> Для стикеров типа "свободное числовое поле" передавайте строку, содержащую число, например "123" или "345.123"; разделитель целой и дробной части — точка "."<br /> Стикер с состояниями, в настройках которого разрешено несколько значений, принимает и возвращает массив ID состояний.
    - `color` 'task-primary' | 'task-gray' | 'task-red' | 'task-pink' | 'task-yellow' | 'task-green' | 'task-turquoise' | 'task-blue' | 'task-violet': Цвет карточки задач на доске, доступны цвета: task-primary, task-gray, task-red, task-pink, task-yellow, task-green, task-turquoise, task-blue, task-violet
    - `idTaskCommon` string: ID задачи, сквозной через всю компанию
    - `idTaskProject` string: ID задачи, внутри проекта
    - `apiData` object: Данные конфигуратора
    - `type` 'task' | 'deal': Тип сущности
    - `stopwatch` Stopwatch
      - `running` boolean, required: Статус секундомера - запущен/остановлен
      - `seconds` number, required: Сколько секунд прошло, пока таймер был запущен.
      - `atMoment` number, required: Момент времени, на который значение seconds было актуально
    - `timer` Timer
      - `seconds` number, required: Сколько секунд осталось до конца таймера.
      - `since` number, required: Timestamp момента времени, от которого отсчитывается значение в поле seconds
      - `running` boolean, required: Статус таймера - запущен/остановлен.
    - `deal` DealReadDto
      - `dealAmount` number: Сумма сделки
      - `customFields` object: Кастомные поля сделки
      - `organizationId` string: ID организации
      - `contactPersonIds` string[]: ID контактных лиц
    - `extensionData` object: Данные расширений
    - `properties` object: Программные свойства задачи JSON-объект

## Other responses

- `404`

## Changes

- **2026-09-24** `0e55bd2c3698`: 1 info
  - added the optional property `content/items/apiData` to the response with the `200` status

[Operation history](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/changes/api-v2/task-list/get.md)

---

[API](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0.md) - [All operations](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/revisions/9452cba35716?raw)