# GET /contacts/{id}/timeline

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

Get the engagement timeline for a contact.

```http
GET https://api.sendheron.com/api/v1/contacts/{id}/timeline
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `contacts:read`

**Success status:** `200`

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | uuid | yes | Contact UUID. |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Zero-indexed page number. Defaults to `0`. |
| `limit` | integer | no | Items per page. |


---

Rate limits (global, all applied at once): 60 per minute, 150 per 5 minutes, 300 per hour, 2000 per day.