---
title: "Deal history (timeline)"
method: GET
path: "/v2/deals/{id}/history"
tags: ["Deals"]
---

# Deal history (timeline)

`GET /v2/deals/{id}/history`

Returns the deal's timeline — the same items shown in the CRM panel's History tab: stage/status/owner changes, notes, tags, e-mails/SMS/calls, completed activities and integration events, for the deal and its contact. Each item carries the raw event `body` (shape varies by `category`) plus a pre-rendered pt-BR `summary` (null for categories without a summarizer). Ordered by event date descending.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

PaginatedV2 envelope with history items: { id, category, date (UTC ISO), system, user: { id, name } | null, body (event-specific object) | null, summary (pt-BR string) | null }

## Other responses

- `400` — Invalid deal id
- `403` — API key missing the deals:read scope
- `404` — Deal not found for this account

---

[API](https://skmtc.net/clint/apis/clint-api.md) · [All operations](https://skmtc.net/clint/apis/clint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clint/clint-api/versions/12b8f9eff943/schema)