> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supersonic.cv/llms.txt
> Use this file to discover all available pages before exploring further.

# Timeline

> Retrieve the full activity timeline for any record, or search across all activity.

The timeline aggregates every touchpoint for a record — emails, calls, meetings, notes, field changes, tasks — into a single chronological feed.

## Tools

| Tool              | Description                         | Key Params                                                  |
| ----------------- | ----------------------------------- | ----------------------------------------------------------- |
| `timeline.get`    | Get the full timeline for a record  | `record_id`, `types` (optional filter), `page`, `page_size` |
| `timeline.search` | Search across all timeline activity | `query`, `record_id` (optional), `types` (optional)         |

### Activity Types

`email` `message` `call` `meeting` `note` `task` `field_change` `stage_change` `record_created` `record_linked`

## Examples

### Get all activity for a contact

```json theme={null}
{
  "tool": "timeline.get",
  "params": {
    "record_id": "rec_contact_01"
  }
}
```

Response:

```json theme={null}
{
  "success": true,
  "data": [
    {
      "type": "email",
      "timestamp": "2026-03-22T16:30:00Z",
      "summary": "Re: Proposal Follow-up",
      "direction": "inbound",
      "source": "gmail"
    },
    {
      "type": "note",
      "timestamp": "2026-03-20T14:30:00Z",
      "summary": "Discovery Call — Jane Smith",
      "note_type": "call"
    },
    {
      "type": "stage_change",
      "timestamp": "2026-03-19T10:00:00Z",
      "summary": "Qualified → Proposal Sent",
      "list_name": "Sales Pipeline"
    },
    {
      "type": "record_created",
      "timestamp": "2026-03-15T09:00:00Z",
      "summary": "Contact created"
    }
  ]
}
```

### Search timeline for mentions of "pricing"

```json theme={null}
{
  "tool": "timeline.search",
  "params": {
    "query": "pricing",
    "record_id": "rec_deal_01"
  }
}
```