API EN
Ранний доступ. Ключи выдаются по запросу. Как получить ключ

История статусов

Изменения статусов лидов, кампаний и аккаунтов, начальный снимок и полнота доступной истории.

Маршруты

#Объект LeadStatusTransition

Фактическое изменение статуса. Набор статусов зависит от entity_kind.

Поля

  • objectstring
    Тип объекта, всегда message.
  • idstring (uuid)
    Непрозрачный устойчивый идентификатор сообщения. Не разбирайте его формат.
  • workspace_idstring (uuid)
    Идентификатор пространства.
  • campaign_idstring (uuid)
    Идентификатор кампании.
  • lead_idstring (uuid) или null
    Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
  • entity_kindstring
    Вид объекта: лид, кампания или аккаунт. Всегда "lead".
  • entity_idstring (uuid)
    Идентификатор объекта, статус которого изменился.
  • entity_revisioninteger
    Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
  • from_statusstring
    Предыдущий публичный статус. Неизвестное значение передается как unknown. Значения: new contacted completed replied blocked failed suspended deleted opted_out unknown
  • to_statusstring
    Новый публичный статус. Неизвестное значение передается как unknown. Значения: new contacted completed replied blocked failed suspended deleted opted_out unknown
  • reason_codestring
    Причина изменения статуса. unspecified, если причина неизвестна. Значения: operator_action schedule queue_exhausted recipient_not_found telegram_auth subscription recovery unspecified
  • sourcestring
    Источник записи. unknown, если он неизвестен. У статистики всегда task_states. Значения: user system support unknown
  • occurred_atstring (date-time)
    Когда произошло изменение.
  • recorded_atstring (date-time)
    Когда изменение или начальный снимок были сохранены.
LeadStatusTransition
{
  "object": "status_transition",
  "id": "00000000-0000-4000-8000-000000000001",
  "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
  "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
  "lead_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
  "entity_kind": "lead",
  "entity_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
  "entity_revision": 1,
  "from_status": "new",
  "to_status": "contacted",
  "reason_code": "operator_action",
  "source": "user",
  "occurred_at": "2026-10-27T09:15:42.000Z",
  "recorded_at": "2026-10-27T09:15:42.000Z"
}

#Объект CampaignStatusTransition

Фактическое изменение статуса. Набор статусов зависит от entity_kind.

Поля

  • objectstring
    Тип объекта, всегда message.
  • idstring (uuid)
    Непрозрачный устойчивый идентификатор сообщения. Не разбирайте его формат.
  • workspace_idstring (uuid)
    Идентификатор пространства.
  • campaign_idstring (uuid)
    Идентификатор кампании.
  • lead_idstring (uuid) или null
    Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
  • entity_kindstring
    Вид объекта: лид, кампания или аккаунт. Всегда "campaign".
  • entity_idstring (uuid)
    Идентификатор объекта, статус которого изменился.
  • entity_revisioninteger
    Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
  • from_statusstring
    Предыдущий публичный статус. Неизвестное значение передается как unknown. Значения: draft scheduled active paused stopped completed archived launching failed paused_no_credits unknown
  • to_statusstring
    Новый публичный статус. Неизвестное значение передается как unknown. Значения: draft scheduled active paused stopped completed archived launching failed paused_no_credits unknown
  • reason_codestring
    Причина изменения статуса. unspecified, если причина неизвестна. Значения: operator_action schedule queue_exhausted recipient_not_found telegram_auth subscription recovery unspecified
  • sourcestring
    Источник записи. unknown, если он неизвестен. У статистики всегда task_states. Значения: user system support unknown
  • occurred_atstring (date-time)
    Когда произошло изменение.
  • recorded_atstring (date-time)
    Когда изменение или начальный снимок были сохранены.
CampaignStatusTransition
{
  "object": "status_transition",
  "id": "00000000-0000-4000-8000-000000000002",
  "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
  "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
  "lead_id": null,
  "entity_kind": "campaign",
  "entity_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
  "entity_revision": 1,
  "from_status": "draft",
  "to_status": "active",
  "reason_code": "operator_action",
  "source": "user",
  "occurred_at": "2026-10-27T09:15:42.000Z",
  "recorded_at": "2026-10-27T09:15:42.000Z"
}

#Объект AccountStatusTransition

Фактическое изменение статуса. Набор статусов зависит от entity_kind.

Поля

  • objectstring
    Тип объекта, всегда message.
  • idstring (uuid)
    Непрозрачный устойчивый идентификатор сообщения. Не разбирайте его формат.
  • workspace_idstring (uuid)
    Идентификатор пространства.
  • campaign_idstring (uuid)
    Идентификатор кампании.
  • lead_idstring (uuid) или null
    Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
  • entity_kindstring
    Вид объекта: лид, кампания или аккаунт. Всегда "account".
  • entity_idstring (uuid)
    Идентификатор объекта, статус которого изменился.
  • entity_revisioninteger
    Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
  • from_statusstring
    Предыдущий публичный статус. Неизвестное значение передается как unknown. Значения: online offline limited banned deleted locked unauthorized paused unknown
  • to_statusstring
    Новый публичный статус. Неизвестное значение передается как unknown. Значения: online offline limited banned deleted locked unauthorized paused unknown
  • reason_codestring
    Причина изменения статуса. unspecified, если причина неизвестна. Значения: operator_action schedule queue_exhausted recipient_not_found telegram_auth subscription recovery unspecified
  • sourcestring
    Источник записи. unknown, если он неизвестен. У статистики всегда task_states. Значения: user system support unknown
  • occurred_atstring (date-time)
    Когда произошло изменение.
  • recorded_atstring (date-time)
    Когда изменение или начальный снимок были сохранены.
AccountStatusTransition
{
  "object": "status_transition",
  "id": "00000000-0000-4000-8000-000000000003",
  "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
  "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
  "lead_id": null,
  "entity_kind": "account",
  "entity_id": "1d9f6b28-4c3e-4a75-8b19-5e7a2c0f6d83",
  "entity_revision": 1,
  "from_status": "online",
  "to_status": "paused",
  "reason_code": "operator_action",
  "source": "user",
  "occurred_at": "2026-10-27T09:15:42.000Z",
  "recorded_at": "2026-10-27T09:15:42.000Z"
}

#Объект StatusBaseline

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

Поля

Вариант 1
  • objectstring
    Тип объекта, всегда message.
  • workspace_idstring (uuid)
    Идентификатор пространства.
  • campaign_idstring (uuid)
    Идентификатор кампании.
  • lead_idstring (uuid) или null
    Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
  • entity_kindstring
    Вид объекта: лид, кампания или аккаунт. Всегда "lead".
  • entity_idstring (uuid)
    Идентификатор объекта, статус которого изменился.
  • entity_revisioninteger
    Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
  • statusstring
    Публичный статус или состояние полноты. Неизвестное значение передается как unknown. Значения: new contacted completed replied blocked failed suspended deleted opted_out unknown
  • recorded_atstring (date-time)
    Когда изменение или начальный снимок были сохранены.
  • provenancestring
    Всегда baseline: начальный снимок, а не изменение статуса.
Вариант 2
  • objectstring
    Тип объекта, всегда message.
  • workspace_idstring (uuid)
    Идентификатор пространства.
  • campaign_idstring (uuid)
    Идентификатор кампании.
  • lead_idstring (uuid) или null
    Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
  • entity_kindstring
    Вид объекта: лид, кампания или аккаунт. Всегда "campaign".
  • entity_idstring (uuid)
    Идентификатор объекта, статус которого изменился.
  • entity_revisioninteger
    Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
  • statusstring
    Публичный статус или состояние полноты. Неизвестное значение передается как unknown. Значения: draft scheduled active paused stopped completed archived launching failed paused_no_credits unknown
  • recorded_atstring (date-time)
    Когда изменение или начальный снимок были сохранены.
  • provenancestring
    Всегда baseline: начальный снимок, а не изменение статуса.
Вариант 3
  • objectstring
    Тип объекта, всегда message.
  • workspace_idstring (uuid)
    Идентификатор пространства.
  • campaign_idstring (uuid)
    Идентификатор кампании.
  • lead_idstring (uuid) или null
    Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
  • entity_kindstring
    Вид объекта: лид, кампания или аккаунт. Всегда "account".
  • entity_idstring (uuid)
    Идентификатор объекта, статус которого изменился.
  • entity_revisioninteger
    Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
  • statusstring
    Публичный статус или состояние полноты. Неизвестное значение передается как unknown. Значения: online offline limited banned deleted locked unauthorized paused unknown
  • recorded_atstring (date-time)
    Когда изменение или начальный снимок были сохранены.
  • provenancestring
    Всегда baseline: начальный снимок, а не изменение статуса.
StatusBaseline
{
  "object": "status_baseline",
  "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
  "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
  "lead_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
  "entity_kind": "lead",
  "entity_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
  "entity_revision": 0,
  "status": "new",
  "recorded_at": "2026-10-26T07:30:00.000Z",
  "provenance": "baseline"
}

#История статусов лида

GET/v1/leads/{id}/status-history

Фактические изменения статуса лида по возрастанию entity_revision. Начальный снимок находится отдельно в meta.baseline. Новые возможности включаются для кабинета по запросу.

Право
leads:read
Вес запроса
2

Параметры

  • idstring (uuid), в путиобязательный
    Идентификатор лида.
  • limitinteger, в строке запросанеобязательный
    Сколько объектов вернуть на странице. От 1 до 100. По умолчанию 50.
  • cursorstring, в строке запросанеобязательный
    Значение next_cursor из предыдущего ответа. Остальные фильтры должны совпадать с первым запросом.

Ответ

Список: object, data (массив объектов LeadStatusTransition), has_more, next_cursor, meta. Подробнее в руководстве Пагинация.

Поле meta

  • baselineobject или null
    Начальный снимок статуса или null. Это не переход и не доказательство более ранней истории.
    Вложенные поля
    • objectstring
      Тип объекта, всегда message.
    • workspace_idstring (uuid)
      Идентификатор пространства.
    • campaign_idstring (uuid)
      Идентификатор кампании.
    • lead_idstring (uuid) или null
      Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
    • entity_kindstring
      Вид объекта: лид, кампания или аккаунт. Всегда "lead".
    • entity_idstring (uuid)
      Идентификатор объекта, статус которого изменился.
    • entity_revisioninteger
      Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
    • statusstring
      Публичный статус или состояние полноты. Неизвестное значение передается как unknown. Значения: new contacted completed replied blocked failed suspended deleted opted_out unknown
    • recorded_atstring (date-time)
      Когда изменение или начальный снимок были сохранены.
    • provenancestring
      Всегда baseline: начальный снимок, а не изменение статуса.
  • available_fromstring (date-time) или null
    Начало периода, за который есть данные. null, если неизвестно.
  • history_started_atstring (date-time) или null
    Когда началось ведение истории. Более ранние изменения не восстанавливаются.
  • retained_fromstring (date-time) или null
    Начало сохраненного периода истории или null, если неизвестно.
  • completenessobject
    Полнота данных. has_more=false означает конец страниц, а не полноту истории.
    Вложенные поля
    • statusstring
      complete, partial или unknown. Значения: complete partial unknown
    • gapsarray of object
      До 50 интервалов возможной неполноты. До 50 элементов.
      Вложенные поля
      • idstring (uuid)
        Идентификатор интервала.
      • fromstring (date-time)
        Начало интервала.
      • tostring (date-time) или null
        Конец интервала. null, если интервал еще не закрыт.
      • statestring
        open, recovering, recovered, unrecoverable или unknown. Значения: open recovering recovered unrecoverable unknown
    • gaps_truncatedboolean
      true, если интервалов больше 50.
    • incomplete_fromstring (date-time) или null
      Самая ранняя граница скрытых неполных интервалов. null, если таких нет.
  • observed_atstring (date-time)
    Время чтения данных сервером.

Особые ошибки

  • cursor_mismatch: Курсор поврежден, выдан для другого маршрута или фильтров, либо права и охват ключа изменились.
  • scope_required: Ключ не разрешает операцию. Для команды нужно право ее вида.
  • not_found: Объект не найден или находится вне охвата ключа. Неизвестный путь тоже дает 404.
  • cursor_expired: Срок курсора истек: 15 минут для списков, 30 суток для ленты событий.

Общие ошибки описаны в руководстве Ошибки.

Запрос
curl https://api.melioralab.io/v1/leads/5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31/status-history \
  -H "Authorization: Bearer $MELIORA_API_KEY"
Ответ
{
  "object": "list",
  "data": [
    {
      "object": "status_transition",
      "id": "00000000-0000-4000-8000-000000000001",
      "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
      "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "lead_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
      "entity_kind": "lead",
      "entity_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
      "entity_revision": 1,
      "from_status": "new",
      "to_status": "contacted",
      "reason_code": "operator_action",
      "source": "user",
      "occurred_at": "2026-10-27T09:15:42.000Z",
      "recorded_at": "2026-10-27T09:15:42.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "meta": {
    "baseline": {
      "object": "status_baseline",
      "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
      "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "lead_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
      "entity_kind": "lead",
      "entity_id": "5a7c3e92-1f4b-4d68-9c2e-7b0a6d4f8e31",
      "entity_revision": 0,
      "status": "new",
      "recorded_at": "2026-10-26T07:30:00.000Z",
      "provenance": "baseline"
    },
    "available_from": "2026-10-26T07:30:00.000Z",
    "history_started_at": "2026-10-26T07:30:00.000Z",
    "retained_from": "2026-10-26T07:30:00.000Z",
    "completeness": {
      "status": "complete",
      "gaps": [],
      "gaps_truncated": false,
      "incomplete_from": null
    },
    "observed_at": "2026-10-27T09:15:42.000Z"
  }
}

#История статусов кампании

GET/v1/campaigns/{id}/status-history

Фактические изменения статуса кампании по возрастанию entity_revision. Новые возможности включаются для кабинета по запросу.

Право
campaigns:read
Вес запроса
2

Параметры

  • idstring (uuid), в путиобязательный
    Идентификатор кампании.
  • limitinteger, в строке запросанеобязательный
    Сколько объектов вернуть на странице. От 1 до 100. По умолчанию 50.
  • cursorstring, в строке запросанеобязательный
    Значение next_cursor из предыдущего ответа. Остальные фильтры должны совпадать с первым запросом.

Ответ

Список: object, data (массив объектов CampaignStatusTransition), has_more, next_cursor, meta. Подробнее в руководстве Пагинация.

Поле meta

  • baselineobject или null
    Начальный снимок статуса или null. Это не переход и не доказательство более ранней истории.
    Вложенные поля
    • objectstring
      Тип объекта, всегда message.
    • workspace_idstring (uuid)
      Идентификатор пространства.
    • campaign_idstring (uuid)
      Идентификатор кампании.
    • lead_idstring (uuid) или null
      Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
    • entity_kindstring
      Вид объекта: лид, кампания или аккаунт. Всегда "campaign".
    • entity_idstring (uuid)
      Идентификатор объекта, статус которого изменился.
    • entity_revisioninteger
      Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
    • statusstring
      Публичный статус или состояние полноты. Неизвестное значение передается как unknown. Значения: draft scheduled active paused stopped completed archived launching failed paused_no_credits unknown
    • recorded_atstring (date-time)
      Когда изменение или начальный снимок были сохранены.
    • provenancestring
      Всегда baseline: начальный снимок, а не изменение статуса.
  • available_fromstring (date-time) или null
    Начало периода, за который есть данные. null, если неизвестно.
  • history_started_atstring (date-time) или null
    Когда началось ведение истории. Более ранние изменения не восстанавливаются.
  • retained_fromstring (date-time) или null
    Начало сохраненного периода истории или null, если неизвестно.
  • completenessobject
    Полнота данных. has_more=false означает конец страниц, а не полноту истории.
    Вложенные поля
    • statusstring
      complete, partial или unknown. Значения: complete partial unknown
    • gapsarray of object
      До 50 интервалов возможной неполноты. До 50 элементов.
      Вложенные поля
      • idstring (uuid)
        Идентификатор интервала.
      • fromstring (date-time)
        Начало интервала.
      • tostring (date-time) или null
        Конец интервала. null, если интервал еще не закрыт.
      • statestring
        open, recovering, recovered, unrecoverable или unknown. Значения: open recovering recovered unrecoverable unknown
    • gaps_truncatedboolean
      true, если интервалов больше 50.
    • incomplete_fromstring (date-time) или null
      Самая ранняя граница скрытых неполных интервалов. null, если таких нет.
  • observed_atstring (date-time)
    Время чтения данных сервером.

Особые ошибки

  • cursor_mismatch: Курсор поврежден, выдан для другого маршрута или фильтров, либо права и охват ключа изменились.
  • scope_required: Ключ не разрешает операцию. Для команды нужно право ее вида.
  • not_found: Объект не найден или находится вне охвата ключа. Неизвестный путь тоже дает 404.
  • cursor_expired: Срок курсора истек: 15 минут для списков, 30 суток для ленты событий.

Общие ошибки описаны в руководстве Ошибки.

Запрос
curl https://api.melioralab.io/v1/campaigns/4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14/status-history \
  -H "Authorization: Bearer $MELIORA_API_KEY"
Ответ
{
  "object": "list",
  "data": [
    {
      "object": "status_transition",
      "id": "00000000-0000-4000-8000-000000000002",
      "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
      "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "lead_id": null,
      "entity_kind": "campaign",
      "entity_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "entity_revision": 1,
      "from_status": "draft",
      "to_status": "active",
      "reason_code": "operator_action",
      "source": "user",
      "occurred_at": "2026-10-27T09:15:42.000Z",
      "recorded_at": "2026-10-27T09:15:42.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "meta": {
    "baseline": {
      "object": "status_baseline",
      "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
      "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "lead_id": null,
      "entity_kind": "campaign",
      "entity_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "entity_revision": 0,
      "status": "draft",
      "recorded_at": "2026-10-26T07:30:00.000Z",
      "provenance": "baseline"
    },
    "available_from": "2026-10-26T07:30:00.000Z",
    "history_started_at": "2026-10-26T07:30:00.000Z",
    "retained_from": "2026-10-26T07:30:00.000Z",
    "completeness": {
      "status": "complete",
      "gaps": [],
      "gaps_truncated": false,
      "incomplete_from": null
    },
    "observed_at": "2026-10-27T09:15:42.000Z"
  }
}

#История статусов аккаунта кампании

GET/v1/campaigns/{id}/accounts/{account_id}/status-history

История аккаунта в контексте выбранной кампании, без раскрытия других кампаний. Новые возможности включаются для кабинета по запросу.

Право
accounts:read
Вес запроса
2

Параметры

  • idstring (uuid), в путиобязательный
    Идентификатор кампании.
  • account_idstring (uuid), в путиобязательный
    Идентификатор аккаунта.
  • limitinteger, в строке запросанеобязательный
    Сколько объектов вернуть на странице. От 1 до 100. По умолчанию 50.
  • cursorstring, в строке запросанеобязательный
    Значение next_cursor из предыдущего ответа. Остальные фильтры должны совпадать с первым запросом.

Ответ

Список: object, data (массив объектов AccountStatusTransition), has_more, next_cursor, meta. Подробнее в руководстве Пагинация.

Поле meta

  • baselineobject или null
    Начальный снимок статуса или null. Это не переход и не доказательство более ранней истории.
    Вложенные поля
    • objectstring
      Тип объекта, всегда message.
    • workspace_idstring (uuid)
      Идентификатор пространства.
    • campaign_idstring (uuid)
      Идентификатор кампании.
    • lead_idstring (uuid) или null
      Идентификатор участия лида в кампании. В истории кампании или аккаунта может быть null.
    • entity_kindstring
      Вид объекта: лид, кампания или аккаунт. Всегда "account".
    • entity_idstring (uuid)
      Идентификатор объекта, статус которого изменился.
    • entity_revisioninteger
      Порядковый номер записи для объекта. Переходы начинаются с 1, начальный снимок может иметь номер 0.
    • statusstring
      Публичный статус или состояние полноты. Неизвестное значение передается как unknown. Значения: online offline limited banned deleted locked unauthorized paused unknown
    • recorded_atstring (date-time)
      Когда изменение или начальный снимок были сохранены.
    • provenancestring
      Всегда baseline: начальный снимок, а не изменение статуса.
  • available_fromstring (date-time) или null
    Начало периода, за который есть данные. null, если неизвестно.
  • history_started_atstring (date-time) или null
    Когда началось ведение истории. Более ранние изменения не восстанавливаются.
  • retained_fromstring (date-time) или null
    Начало сохраненного периода истории или null, если неизвестно.
  • completenessobject
    Полнота данных. has_more=false означает конец страниц, а не полноту истории.
    Вложенные поля
    • statusstring
      complete, partial или unknown. Значения: complete partial unknown
    • gapsarray of object
      До 50 интервалов возможной неполноты. До 50 элементов.
      Вложенные поля
      • idstring (uuid)
        Идентификатор интервала.
      • fromstring (date-time)
        Начало интервала.
      • tostring (date-time) или null
        Конец интервала. null, если интервал еще не закрыт.
      • statestring
        open, recovering, recovered, unrecoverable или unknown. Значения: open recovering recovered unrecoverable unknown
    • gaps_truncatedboolean
      true, если интервалов больше 50.
    • incomplete_fromstring (date-time) или null
      Самая ранняя граница скрытых неполных интервалов. null, если таких нет.
  • observed_atstring (date-time)
    Время чтения данных сервером.

Особые ошибки

  • cursor_mismatch: Курсор поврежден, выдан для другого маршрута или фильтров, либо права и охват ключа изменились.
  • scope_required: Ключ не разрешает операцию. Для команды нужно право ее вида.
  • not_found: Объект не найден или находится вне охвата ключа. Неизвестный путь тоже дает 404.
  • cursor_expired: Срок курсора истек: 15 минут для списков, 30 суток для ленты событий.

Общие ошибки описаны в руководстве Ошибки.

Запрос
curl https://api.melioralab.io/v1/campaigns/4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14/accounts/1d9f6b28-4c3e-4a75-8b19-5e7a2c0f6d83/status-history \
  -H "Authorization: Bearer $MELIORA_API_KEY"
Ответ
{
  "object": "list",
  "data": [
    {
      "object": "status_transition",
      "id": "00000000-0000-4000-8000-000000000003",
      "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
      "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "lead_id": null,
      "entity_kind": "account",
      "entity_id": "1d9f6b28-4c3e-4a75-8b19-5e7a2c0f6d83",
      "entity_revision": 1,
      "from_status": "online",
      "to_status": "paused",
      "reason_code": "operator_action",
      "source": "user",
      "occurred_at": "2026-10-27T09:15:42.000Z",
      "recorded_at": "2026-10-27T09:15:42.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "meta": {
    "baseline": {
      "object": "status_baseline",
      "workspace_id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
      "campaign_id": "4d8b2f73-6e1a-4c95-b7d0-8a3f5e2c9b14",
      "lead_id": null,
      "entity_kind": "account",
      "entity_id": "1d9f6b28-4c3e-4a75-8b19-5e7a2c0f6d83",
      "entity_revision": 0,
      "status": "online",
      "recorded_at": "2026-10-26T07:30:00.000Z",
      "provenance": "baseline"
    },
    "available_from": "2026-10-26T07:30:00.000Z",
    "history_started_at": "2026-10-26T07:30:00.000Z",
    "retained_from": "2026-10-26T07:30:00.000Z",
    "completeness": {
      "status": "complete",
      "gaps": [],
      "gaps_truncated": false,
      "incomplete_from": null
    },
    "observed_at": "2026-10-27T09:15:42.000Z"
  }
}