# List notes

Retrieve all internal notes for an event.

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

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

Returns all notes for the event, sorted by timestamp ascending. Notes are **never visible** on published status dashboards.

***

## 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/notes \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

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

```json
{
  "notes": [
    {
      "noteId": "2e8c5b9a-4d7f-4a0b-b2d4-e5f6789abcde",
      "timestamp": "2026-04-25T10:15:00.000Z",
      "note": "Escalated to database team at 10:15 UTC. Pager duty alert sent.",
      "author": "user@example.com",
      "isEdited": false
    }
  ]
}
```

***

## Response fields
| Field   | Type  | Description                                     |
| ------- | ----- | ----------------------------------------------- |
| `notes` | array | Internal notes sorted by `timestamp` ascending. |

### Note fields
Each `notes[]` item matches [Get note](/docs/api/event-management/events/notes/get#response-fields). The `note` text field uses the same constraints as [Create note](/docs/api/event-management/events/notes/create#body-fields).

| Field       | Type    | Description                                          |
| ----------- | ------- | ---------------------------------------------------- |
| `noteId`    | string  | Unique note ID.                                      |
| `timestamp` | string  | ISO 8601 UTC timestamp of when the note was created. |
| `note`      | string  | Note text.                                           |
| `author`    | string  | Email of the user who created the note.              |
| `isEdited`  | boolean | Whether the note has been edited since creation.     |

***

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