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

`GET /v1/tasks/:id`

Возвращает одну задачу со всеми полями. Дополнительно к полям списка приходят встроенные объекты постановщика и ответственного, чек-лист, разрешённые действия и расширенная информация о соисполнителях и наблюдателях.

## Параметры

| Параметр | Тип | Обяз. | Описание |
|----------|-----|:-----:|---------|
| `id` (path) | number | да | ID задачи |

## Примеры

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

```bash
curl "https://vibecode.bitrix24.tech/v1/tasks/289" \
  -H "X-Api-Key: YOUR_API_KEY"
```

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

```bash
curl "https://vibecode.bitrix24.tech/v1/tasks/289" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"
```

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

```javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log(data.title, '— статус:', data.status)
```

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

```javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()
```

## Поля ответа

| Поле | Тип | Описание |
|------|-----|---------|
| `success` | boolean | Всегда `true` при успехе |
| `data` | object | Объект задачи. Базовые поля — см. [Поля задачи](./fields.md). Дополнительные блоки описаны ниже |

**Дополнительные блоки одиночного ответа:**

| Поле | Тип | Описание |
|------|-----|---------|
| `data.creator` | object | Постановщик: `{ id, name, link, icon, workPosition }` |
| `data.responsible` | object | Ответственный: тот же формат, что и `creator` |
| `data.accomplicesData` | object[] | Подробности по соисполнителям (тот же формат, что и `creator`) |
| `data.auditorsData` | object[] | Подробности по наблюдателям (тот же формат, что и `creator`) |
| `data.action` | object | Карта разрешённых действий (boolean): `complete`, `start`, `pause`, `delegate`, `remove`, `edit`, `defer`, `changeDeadline`, `checklistAddItems` и другие |
| `data.checklist` | array | Пункты чек-листа (пустой массив, если чек-лист не заполнен) |
| `data.checkListTree` | object | Дерево чек-листа с метаданными |
| `data.newCommentsCount` | number | Количество непрочитанных комментариев |

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

```json
{
  "success": true,
  "data": {
    "id": 289,
    "title": "Подготовить отчёт за квартал",
    "description": "",
    "status": 2,
    "priority": 1,
    "groupId": 0,
    "responsibleId": 79,
    "createdBy": 99,
    "createdDate": "2026-05-12T06:11:18.000Z",
    "changedDate": "2026-05-12T06:11:18.000Z",
    "deadline": "2026-05-19T15:00:00.000Z",
    "accomplices": [],
    "auditors": [],
    "checklist": [],
    "creator": {
      "id": "99",
      "name": "Анна Соколова",
      "link": "/company/personal/user/99/",
      "icon": "https://example.bitrix24.ru/.../avatar.png",
      "workPosition": null
    },
    "responsible": {
      "id": "79",
      "name": "Дмитрий Орлов",
      "link": "/company/personal/user/79/",
      "icon": "/bitrix/images/tasks/default_avatar.png",
      "workPosition": null
    },
    "newCommentsCount": 0,
    "action": {
      "complete": true,
      "start": true,
      "delegate": true,
      "edit": true,
      "remove": true,
      "defer": true,
      "changeDeadline": true
    }
  }
}
```

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

404 — задача не найдена:

```json
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "task 999999999 not found"
  }
}
```

## Ошибки

| HTTP | Код | Описание |
|------|-----|---------|
| 404 | `ENTITY_NOT_FOUND` | Задача с таким ID не найдена |
| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `tasks` |
| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |
| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |

Полный список общих ошибок API — [Ошибки](/docs/errors).

## Известные особенности

**Встроенные данные пользователей.** Поля `creator` и `responsible` приходят вложенным объектом с именем, ссылкой на профиль и аватаркой. Отдельный `GET /v1/users/:id` для отображения автора задачи не требуется.

**Приведение типов работает на верхнем уровне, внутрь объектов не заходит.** Поля-карточки (`creator`, `responsible`, `group`, `accomplicesData`, `auditorsData`) объявлены объектами и приходят от Битрикс24 как есть — значения внутри них остаются в том виде, в каком их отдал портал, в том числе `creator.id` строкой (`"99"`). Это не то же самое, что верхнеуровневый `createdBy`, который приходит числом. Для арифметики по вложенному идентификатору приводите через `Number()`.

**Типы значений соответствуют схеме.** Поля, объявленные в [схеме](./fields.md) числами, приходят числами — включая `commentsCount`, `serviceCommentsCount` и `chatId`, который раньше был строкой в списке и числом в карточке. Признаки «да/нет» приходят значениями `true`/`false`, пустые `tags`, `group`, `accomplicesData`, `auditorsData` — пустым объектом `{}`. Приведение через `Number(value)` больше не требуется.

## Смотрите также

- [Список задач](./list.md)
- [Поля задачи](./fields.md)
- [Обновить задачу](./update.md)
- [Удалить задачу](./delete.md)
- [Комментарии задачи](/docs/entities/task-comments)
- [Учёт времени](./time.md)
- [Чек-лист задачи](./checklist.md)
- [Лимиты и оптимизация](/docs/optimization)