---
title: "List the notes on a thread"
description: "The private notes on one thread, pinned ones first."
url: "https://openemail.uk/docs/api/notes/list"
area: "API"
category: "Mailbox"
---

# List the notes on a thread

The private notes on one thread, pinned ones first.

`GET /threads/{id}/notes`

## GET /threads/{id}/notes

The private notes on one thread, pinned ones first.

## Example

Needs `threads:read`. The notes come back in the order the Notes panel shows them: pinned first, then the rest as they were arranged.

**curl**

```
curl "$OE/threads/thr_7c1e4a90/notes" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
      "object": "note",
      "id": "b3d1f0c2-7a4e-4f7b-9c1d-2e8f6a5b4c3d",
      "threadId": "thr_7c1e4a90",
      "content": "Waiting on the signed contract before replying.",
      "color": "yellow",
      "pinned": true,
      "order": 4,
      "createdAt": "2026-09-30T09:12:44.000Z",
      "updatedAt": "2026-09-30T09:12:44.000Z"
    }]
}
```

> Notes are private to a person. A key reads and writes the notes of the workspace owner, and an app those of the person who connected it.

> A key limited to particular addresses or domains reaches only the notes on threads that arrived at them, and any other thread is a 404.

## Reference

- [`GET /threads/{id}/notes`](https://openemail.uk/docs/api/reference/notes#get-threads-id-notes): full reference