---
title: "Получить по ID"
method: GET
path: "/api-v2/tasks/{id}"
tags: ["Задачи"]
---

# Получить по ID

`GET /api-v2/tasks/{id}`

## 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/tasks/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

- TaskDto
  - `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 `apiData` to the response with the `200` status

[Operation history](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/changes/api-v2/tasks/:id/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)