# Get a contact's timeline

> Returns the full conversation with a contact across all channels, in chronological order (the most recent 200 messages), plus any autosaved email draft in…

Source: https://warmerly.com/docs/inbox/get-a-contact-s-timeline

```text
GET /inbox/contacts/{contactId}/timeline
```

Returns the full conversation with a contact across all channels, in chronological order (the most recent 200 messages), plus any autosaved email draft in progress for the latest inbound thread. **Reading a timeline marks its unread messages as read**, as opening the conversation in the dashboard does. Add `?preview=1` to read without marking anything read.

```bash
curl https://app.warmerly.com/api/v1/inbox/contacts/c3a1f6e2-9c4d-4e2a-8b5f-6a2c1d9e0f7b/timeline \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

```json
{
  "items": [
    {
      "id": "9d1e0b7a-5e7b-4f10-b2aa-1c8f0d3e6a4b",
      "channel": "email",
      "direction": "inbound",
      "status": "sent",
      "content": "Hi, thanks for the intro, happy to learn more.",
      "bodyHtml": "<p>Hi, thanks for the intro, happy to learn more.</p>",
      "subject": "Re: Quick question about your workflow",
      "sentAt": "2026-06-30T11:05:00.000Z",
      "fromAddr": "jamie@northwindtraders.com",
      "fromName": "Jamie Rivera",
      "toAddrs": ["you@yourcompany.com"],
      "externalId": null,
      "error": null,
      "hasAttachments": false,
      "attachmentsMeta": null,
      "isWarmup": false,
      "sentBy": null
    },
    {
      "id": "7f3a2cdb-9e1a-4f0c-8b6d-2e5f7a1c3b9d",
      "channel": "email",
      "direction": "outbound",
      "status": "sent",
      "content": "Great, does Tuesday at 3pm work for a quick call?",
      "bodyHtml": null,
      "subject": "Re: Quick question about your workflow",
      "sentAt": "2026-07-01T16:42:03.000Z",
      "fromAddr": "you@yourcompany.com",
      "fromName": "Your Name",
      "toAddrs": ["jamie@northwindtraders.com"],
      "externalId": null,
      "error": null,
      "hasAttachments": false,
      "attachmentsMeta": null,
      "isWarmup": false,
      "sentBy": null
    }
  ],
  "draft": null,
  "latestSubject": "Re: Quick question about your workflow",
  "replyAccountId": "8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a",
  "contact": {
    "id": "c3a1f6e2-9c4d-4e2a-8b5f-6a2c1d9e0f7b",
    "category": "lead",
    "categoryReason": "Replied positively and asked to schedule a call"
  }
}
```

| Field | Type | Description |
| --- | --- | --- |
| `items[].channel` | `"email"` \\| `"linkedin"` | Channel the message was sent/received on. |
| `items[].direction` | `"inbound"` \\| `"outbound"` | Who sent it. |
| `items[].status` | `"queued"` \\| `"sent"` \\| `"failed"` | Delivery status. |
| `items[].content` | string | Plain-text body (falls back to snippet if the full body wasn't stored). |
| `items[].hasAttachments` | boolean | Whether the message has attachments. |
| `items[].attachmentsMeta` | array \\| null | Attachment details (`filename`, `contentType`, `size`, `part`), usable with the attachment download endpoint. |
| `items[].isWarmup` | boolean | True for Warmerly warmup traffic. |
| `items[].sentBy` | `"autopilot"` \\| null | `"autopilot"` when LinkedIn AI Autopilot sent the message. |
| `draft` | object \\| null | Autosaved email draft for the latest inbound email thread, if one exists (`subject`, `bodyText`). |
| `latestSubject` | string \\| null | Subject of the most recent message that has one. |
| `replyAccountId` | string \\| null | The mailbox the email thread started on, which replies are sent from. |

If `contactId` doesn't exist, or has no message in your workspace, this returns `404`:

```json
{ "error": { "code": "not_found", "message": "not_found", "details": null } }
```

## More from Inbox

- [Reply to a contact](https://warmerly.com/docs/inbox/reply-to-a-contact): Sends a reply to a contact on a specific channel and appends it to the timeline. Each channel has its own…
- [List threads](https://warmerly.com/docs/inbox/list-threads): Returns email threads (grouped by threadKey + accountId) with aggregate counts, for building a mailbox-style…
- [Get a thread](https://warmerly.com/docs/inbox/get-a-thread): Returns the raw messages in a single email thread, chronological order (the most recent 200). {key} is the…