---
title: "Получить единую хронологию лида, сделки или клиента"
method: GET
path: "/api/v1/crm/{entity}/{id}/timeline"
tags: ["CRM links"]
---

# Получить единую хронологию лида, сделки или клиента

`GET /api/v1/crm/{entity}/{id}/timeline`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/{entity}/{id}/timeline`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Заметки и системные факты с изменениями полей, дела, смены этапов сделки, решения по лиду, связи и переписка привязанных диалогов одной лентой по возрастанию времени. У записи указан источник: менеджер, API, автоматизация, импорт или слияние. Переписка видна только из диалогов, доступных читающему в разделе «Коммуникации». Лента клиента сверх своих записей собирает события его сделок и лидов, которые читающему доступны. Лента любой записи отдаётся страницами от курсора: без курсора - самые свежие записи; отбор kinds применяется до страницы

## Query parameters

- `limit` integer
- `before` string, date-time
- `before_id` string, uuid
- `kinds` string

## Response `200`

Записи ленты от старых к новым

- CRMTimelineEntry[]
  - `id` string, uuid, required
  - `kind` 'note' | 'system' | 'stage' | 'decision' | 'message' | 'link' | 'engagement' | 'file' | 'mail', required: note - заметка сотрудника, system - системный факт или правка полей, stage - смена этапа, decision - решение по лиду, message - сообщение канала, link - связь с задачей, событием или встречей, engagement - дело: звонок, встреча, задача, file - файл прикреплён к записи или удалён, mail - письмо отправлено из карточки, привязано к ней или отвязано
  - `at` string, date-time, required
  - `actor_id` integer
  - `actor_name` string
  - `title` string, required: Заголовок записи: действие, название этапа, решение или направление сообщения
  - `body` string
  - `meta` object, nullable: Подробности записи. У заметки: mentions - упомянутые коллеги [{id, name}], их имена стоят в тексте как «@Имя»
  - `source` 'ui' | 'api' | 'automation' | 'import' | 'merge' | 'system': Откуда пришла запись: ui - менеджер в интерфейсе, api - внешний API, automation - робот, import - импорт, merge - слияние дублей, system - система. Пусто у переписки и у старых записей
  - `record_type` 'lead' | 'deal' | 'customer': Запись, которой принадлежит событие. В ленте клиента это его сделка или лид, а не он сам
  - `record_id` string, uuid
  - `record_title` string: Название записи; заполняется только в ленте клиента

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)