# List a lead's notes

`GET https://app.whatsetter.com/api/v1/leads/{id}/notes`

The notes written on this lead, newest first (at most 100): from the
dashboard's journal and from the API. `author` is the person's name,
or `API · <key name>` for notes added with a key. Requires scope
`leads:read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes |  |

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/leads/{id}/notes' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The notes, newest first

```json
{
  "data": [
    {
      "id": "68ed11aa22bb33cc44dd55ee",
      "text": "Wants a call after the 25th, budget confirmed.",
      "author": "API · HubSpot sync",
      "created_at": "2026-09-19T08:14:02.000Z"
    },
    {
      "id": "68ec0099aa88bb77cc66dd55",
      "text": "Asked for the brochure, sent.",
      "author": "Julien Martin",
      "created_at": "2026-09-17T15:20:41.000Z"
    }
  ]
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 404: Resource not found in this workspace

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listleadnotes/
