Для AI-агентов: markdown этой страницы — /docs-content/entities/crm-tracking/expenses-list.md индекс документации — /llms.txt

Список расходов источника сквозной аналитики

GET /v1/crm-tracking/sources/:id/expenses

Перечисляет только добавленные вручную пакеты расходов выбранного источника сквозной аналитики. Расходы рекламных интеграций в список не входят.

Метод выходит в обновлении crm 26.2100.0 и доступен не на всех порталах Битрикс24. Если метод ещё не включён, API вернёт 422 METHOD_NOT_YET_AVAILABLE.

Требуется скоуп crm, включённый флаг crm-tracking-v3 и доступность возможности на портале Битрикс24. Для чтения подходит ключ READONLY.

Параметры

Параметр Тип Обяз. По умолч. Описание
Параметрid (path) Типnumber Обяз.да По умолч.— ОписаниеПоложительный целочисленный ID источника из списка источников.
Параметрlimit (query) Типnumber Обяз.нет По умолч.50 ОписаниеРазмер страницы, целое число от 1 до 500.
Параметрoffset (query) Типnumber Обяз.нет По умолч.0 ОписаниеЧисло пропускаемых записей, неотрицательное целое число.

Пагинация: один запрос возвращает одну страницу без автоматического получения следующих страниц. Для следующей страницы увеличьте offset на limit. Расходы идут от новых к старым. Сортировка, дополнительные фильтры и выбор полей не поддерживаются.

Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/crm-tracking/sources/2/expenses?limit=50&offset=0" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/crm-tracking/sources/2/expenses?limit=50&offset=0" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/crm-tracking/sources/2/expenses?limit=50&offset=0', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const result = await res.json()
console.log(result)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/crm-tracking/sources/2/expenses?limit=50&offset=0', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const result = await res.json()
console.log(result)

Поля ответа

Поле Тип Описание
Полеsuccess Типboolean Описаниеtrue
Полеdata Типarray ОписаниеРасходы источника.
Полеdata[].id Типnumber ОписаниеID расхода из этого списка.
Полеdata[].sourceId Типnumber ОписаниеID источника из списка источников.
Полеdata[].dateFrom Типstring ОписаниеНачало периода, YYYY-MM-DD.
Полеdata[].dateTo Типstring ОписаниеКонец периода, YYYY-MM-DD.
Полеdata[].amount Типnumber ОписаниеСумма расхода в единицах валюты currencyId, например 12.5 — 12,50 доллара при USD.
Полеdata[].currencyId Типstring ОписаниеКод валюты расхода.
Полеdata[].actions Типnumber ОписаниеКоличество действий.
Полеdata[].comment Типstring | null ОписаниеКомментарий к расходу.
Полеdata[].createdTime Типstring | null ОписаниеВремя создания, если оно передано Битрикс24.
Полеmeta.limit Типnumber ОписаниеРазмер запрошенной страницы.
Полеmeta.offset Типnumber ОписаниеЧисло пропускаемых записей.

Общее количество записей в ответе не передаётся.

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

Пример структуры ответа.

JSON 
{
  "success": true,
  "data": [
    {
      "id": 7,
      "sourceId": 2,
      "dateFrom": "2026-10-01",
      "dateTo": "2026-10-07",
      "amount": 12.5,
      "currencyId": "USD",
      "actions": 0,
      "comment": "Campaign",
      "createdTime": null
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0
  }
}

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

400 — неподдерживаемый параметр запроса:

JSON 
{
  "success": false,
  "error": {
    "code": "UNKNOWN_FILTER_FIELD",
    "message": "Unknown query parameter"
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_PARAMS ОписаниеНекорректный ID источника или параметры пагинации.
HTTP400 КодUNKNOWN_FILTER_FIELD ОписаниеПередан неизвестный параметр, фильтр, сортировка или выбор полей.
HTTP403 КодSCOPE_DENIED ОписаниеУ ключа нет скоупа crm.
HTTP401 КодTOKEN_MISSING ОписаниеУ ключа нет настроенных токенов.
HTTP422 КодMETHOD_NOT_YET_AVAILABLE ОписаниеФлаг выключен или метод ещё не включён на портале. error.release — crm 26.2100.0.
HTTP502 КодBITRIX_UNAVAILABLE ОписаниеБитрикс24 вернул некорректную структуру списка.

Коды, HTTP-статусы и тексты остальных отказов Битрикс24 сохраняются с удалением секретных значений из текста. Полный список общих ошибок API — Ошибки.

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

Суммы и валюта передаются из Битрикс24 без пересчёта. Текстовые значения очищаются от секретных данных.

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