---
title: "Find Related Notes"
method: GET
path: "/v2/notes/{note_id}/related-notes"
tags: ["external", "external-v2"]
---

# Find Related Notes

`GET /v2/notes/{note_id}/related-notes`

Find notes semantically related to the current persisted content of a note.
The source note is embedded at request time, so newly created or recently
updated notes can be used before asynchronous indexing catches up.
Candidate related notes still come from the note search index.

## Path parameters

- `note_id` string, uuid, required — UUID of the source note. The caller must be able to access this note.

## Query parameters

- `limit` integer — Maximum number of related notes to return. Default is 10; valid range is 1 to 20.

## Response `200`

OK

- FindRelatedNotesResponseSchema
  - `request_id` string, required — Identifier for this API request. Useful for tracing and support.
  - `results` RelatedNoteItemResponseSchema[], required — Related notes ordered by vector similarity.
    - `collection_ids` string[], required — Accessible collection UUIDs currently associated with the note.
    - `collections` RelatedNoteCollectionResponseSchema[], required — Accessible collection context for the related note.
      - `created_at` string, date-time, required — Creation timestamp for the collection in ISO 8601 format.
      - `description` string, nullable — Current collection description, if one is set.
      - `id` string, uuid, required — UUID of the collection.
      - `is_shared` boolean, required — Whether this collection is shared with other accounts.
      - `note_count` integer, required — Number of active notes currently linked to the collection.
      - `title` string, required — Current collection title.
      - `updated_at` string, date-time, required — Last modification timestamp for the collection in ISO 8601 format.
    - `created_at` string, date-time, required — Creation timestamp for the note in ISO 8601 format.
    - `id` string, uuid, required — UUID of the related note.
    - `preview` string, required — Truncated markdown preview of the related note's current content. Use `GET /v2/notes/{note_id}` for the full note body.
    - `score` number, nullable — Similarity score returned by the note vector index.
    - `snippet` string, nullable — Optional derived note snippet for quick display.
    - `title` string, required — Current title of the related note.
    - `updated_at` string, date-time, required — Last modification timestamp for the note in ISO 8601 format.
  - `total` integer, required — Number of related notes returned.

---

[API](https://skmtc.net/mem/apis/mem-api.md) · [All operations](https://skmtc.net/mem/apis/mem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mem/mem-api/revisions/4023cb07f31f/schema)
