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

GET /v1/tasks/:id

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

#Параметры

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

#Примеры

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

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

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

Terminal 
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 Объект задачи. Базовые поля — см. Поля задачи. Дополнительные блоки описаны ниже

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

Поле Тип Описание
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-12T09:11:18+03:00",
    "changedDate": "2026-05-12T09:11:18+03:00",
    "deadline": "2026-05-19T18:00:00+03:00",
    "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 — Ошибки.

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

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

Числовые значения как строки. Все числовые поля (id, status, priority, responsibleId, createdBy, groupId, newCommentsCount и подобные) приходят строками. Для арифметики и сравнений приводите через Number(value).

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