---
type: api
title: Get notes
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v8/operation/operation-getnotes
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v8/operation/operation-getnotes
products:
  - Kibana
---

# Get notes

Authentication: required

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/note`
- `GET` `/s/{space_id}/api/note`

#### Path parameters

- `space_id` (string) — optional
  An identifier for the space. If `space_id` is not provided in the URL, the default space is used. Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

## Description

Get all notes for a given document.

## Query string parameters

- `documentIds` (union string[] | string) — optional
- `savedObjectIds` (union string[] | string) — optional
- `page` (string) — optional — nullable
- `perPage` (string) — optional — nullable
- `search` (string) — optional — nullable
- `sortField` (string) — optional — nullable
- `sortOrder` (string) — optional — nullable
- `filter` (string) — optional — nullable
- `createdByFilter` (string) — optional — nullable
- `associatedFilter` (enum) — optional
  Values: `all`, `document_only`, `saved_object_only`, `document_and_saved_object`, `orphan`

## Response

Indicates the requested notes were returned.

`application/json`

One of:
- **GetNotesResult**
  - `notes` (object[])
    - `created` (number) — nullable
      The time the note was created, using a 13-digit Epoch timestamp.
    - `createdBy` (string) — nullable
      The user who created the note.
    - `updated` (number) — nullable
      The last time the note was updated, using a 13-digit Epoch timestamp
    - `updatedBy` (string) — nullable
      The user who last updated the note
    - `eventId` (string) — nullable
      The `_id` of the associated event for this note.
    - `note` (string) — nullable
      The text of the note
    - `timelineId` (string)
      The `savedObjectId` of the Timeline that this note is associated with
    - `noteId` (string)
      The `savedObjectId` of the note
    - `version` (string)
      The version of the note
  - `totalCount` (number)
- **object**
## Code examples

#### Console

```console
GET kbn:/api/note
```

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/note" \
  -H "Authorization: ApiKey ${API_KEY}"
```

## Response examples

#### 200

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "notes": [
    {
      "created": 1587468588922,
      "createdBy": "casetester",
      "updated": 1741344876825,
      "updatedBy": "casetester",
      "eventId": "d3a1d35a3e84a81b2f8f3859e064c224cdee1b4bc",
      "note": "This is an example text",
      "timelineId": "15c1929b-0af7-42bd-85a8-56e234cc7c4e",
      "noteId": "709f99c6-89b6-4953-9160-35945c8e174e",
      "version": "WzQ2LDFd"
    }
  ],
  "totalCount": 0
}
```