#Получить элемент смарт-процесса

GET /v1/items/:entityTypeId/:id

Возвращает элемент смарт-процесса по ID.

#Параметры запроса

Параметр Тип Описание
entityTypeId number ID типа смарт-процесса (в URL)
id number ID элемента (в URL)

#Примеры

В примерах entityTypeId = 156, id = 783 — замените на ваши значения.

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

Terminal 
curl -X GET https://vibecode.bitrix24.tech/v1/items/156/783 \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X GET https://vibecode.bitrix24.tech/v1/items/156/783 \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

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

const { success, data } = await res.json()
console.log('Элемент:', data.title)

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

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

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

#Поля ответа

Поле Тип Описание
id number ID элемента
title string Название
xmlId string Внешний код
stageId string Стадия
categoryId number ID воронки
companyId number ID компании
contactId number ID контакта
contactIds array Привязанные контакты
opportunity number Сумма
currencyId string Валюта
opened boolean Доступен для всех
assignedById number Ответственный
createdBy number Создатель
updatedBy number Последний редактор
movedBy number Переместил стадию
createdTime datetime Дата создания
updatedTime datetime Дата изменения
movedTime datetime Дата смены стадии
observers array Наблюдатели

Ответ содержит все поля элемента, включая пользовательские (ufCrmN_*) и родительские ссылки (parentIdN).

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

JSON 
{
  "success": true,
  "data": {
    "id": 783,
    "title": "Договор на поставку",
    "xmlId": null,
    "stageId": "DT156_41:NEW",
    "categoryId": 41,
    "companyId": 15,
    "contactId": 42,
    "contactIds": [42],
    "opportunity": 500000,
    "currencyId": "RUB",
    "opened": true,
    "assignedById": 1,
    "createdBy": 1,
    "updatedBy": 1,
    "movedBy": 1,
    "createdTime": "2026-04-15T14:30:00+03:00",
    "updatedTime": "2026-04-15T14:30:00+03:00",
    "movedTime": "2026-04-15T14:30:00+03:00",
    "observers": [1, 5],
    "mycompanyId": 0
  }
}

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

404 — элемент не найден:

JSON 
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Entity not found"
  }
}

#Ошибки

HTTP Код Описание
404 NOT_FOUND Элемент с указанным ID не найден
403 SCOPE_DENIED API-ключ не имеет скоупа crm
401 TOKEN_MISSING API-ключ не имеет настроенных токенов
400 RESERVED_ENTITY_TYPE entityTypeId зарезервирован

Полный список общих ошибок API — Ошибки.

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