# List timeline entries

Retrieve all timeline entries for an event.

Source: https://statusdashboard.com/docs/api/event-management/events/timeline/list

`GET /app/events/{id}/timeline`

Returns all timeline entries for the event, sorted by timestamp ascending (oldest first).

***

## Path parameters
| Parameter | Description   |
| --------- | ------------- |
| `id`      | The event ID. |

***

## Request
See [API Basics](/docs/api) for required headers.

This endpoint takes no request body.

***

## Sample request
```bash
curl https://api.statusdashboard.com/app/events/4f8b2e1a-3c7d-4e9f-a0b1-c2d3e4f56789/timeline \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "timeline": [
    {
      "statusId": "7a3f9d2e-1b4c-4e8a-90b2-c3d4e5f67890",
      "timestamp": "2026-04-25T09:45:00.000Z",
      "status": "Investigating",
      "message": "We are aware of elevated API response times and are investigating.",
      "author": "user@example.com",
      "isEdited": false
    }
  ]
}
```

***

## Response fields
| Field      | Type  | Description                                       |
| ---------- | ----- | ------------------------------------------------- |
| `timeline` | array | Timeline entries sorted by `timestamp` ascending. |

### Timeline entry fields
Each `timeline[]` item matches [Get timeline entry](/docs/api/event-management/events/timeline/get#response-fields).

| Field       | Type    | Description                                                                                                |
| ----------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `statusId`  | string  | Unique entry ID.                                                                                           |
| `timestamp` | string  | ISO 8601 UTC timestamp for this entry. Set at creation; editable via PUT.                                  |
| `status`    | string  | Workflow phase label at time of posting. Cannot be changed after posting.                                  |
| `message`   | string  | Status message. Rich text field. See [Rich text fields](/docs/api#rich-text-fields). Max 5,000 characters. |
| `author`    | string  | Email of the user who posted the entry.                                                                    |
| `isEdited`  | boolean | `true` if the message or timestamp has been edited since posting.                                          |

***

## Error responses
| Status | When                      |
| ------ | ------------------------- |
| `403`  | Insufficient permissions. |
| `404`  | Event not found.          |