> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Find 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.



## OpenAPI

````yaml GET /v2/notes/{note_id}/related-notes
openapi: 3.1.0
info:
  title: Mem API
  description: An API that allows you to interact with the Mem platform.
  version: 1.0.0
servers:
  - url: https://api.mem.ai
security:
  - bearerAuth: []
paths:
  /v2/notes/{note_id}/related-notes:
    get:
      tags:
        - external
        - external-v2
      summary: Find Related Notes
      description: >-
        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.
      operationId: app_src_api_routes_external_v2_notes_views_find_related_notes
      parameters:
        - in: query
          name: limit
          schema:
            default: 10
            description: |-
              Maximum number of related notes to return.
              Default is 10; valid range is 1 to 20.
            maximum: 20
            minimum: 1
            title: Limit
            type: integer
          required: false
          description: |-
            Maximum number of related notes to return.
            Default is 10; valid range is 1 to 20.
        - in: path
          name: note_id
          schema:
            description: >-
              UUID of the source note. The caller must be able to access this
              note.
            format: uuid
            title: Note Id
            type: string
          required: true
          description: >-
            UUID of the source note. The caller must be able to access this
            note.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindRelatedNotesResponseSchema'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >-
            curl
            "https://api.mem.ai/v2/notes/01961d40-7a67-7049-a8a6-d5638cbaaeb9/related-notes?limit=10"
            \
                 --header "Authorization: Bearer $MEM_API_KEY"
components:
  schemas:
    FindRelatedNotesResponseSchema:
      example:
        request_id: api-request-018f8d0d-5a3c-7afc-8321-2f6f6e0fefab
        results:
          - collection_ids:
              - 59508b41-8770-4855-aa37-302b1e09aee7
            collections:
              - created_at: '2025-03-18T11:00:00Z'
                description: Planning documents and project notes.
                id: 59508b41-8770-4855-aa37-302b1e09aee7
                is_shared: false
                note_count: 8
                title: Work Projects
                updated_at: '2025-04-22T16:12:34Z'
            created_at: '2025-03-18T11:00:00Z'
            id: 018f8d0d-5a3c-7afc-8321-2f6f6e0fefab
            preview: |-
              # Project Phoenix Planning

              Launch goals and milestones.
            score: 0.91
            snippet: Launch goals and milestones.
            title: Project Phoenix Planning
            updated_at: '2025-04-22T16:12:34Z'
        total: 1
      properties:
        request_id:
          description: Identifier for this API request. Useful for tracing and support.
          title: Request Id
          type: string
        results:
          description: Related notes ordered by vector similarity.
          items:
            $ref: '#/components/schemas/RelatedNoteItemResponseSchema'
          title: Results
          type: array
        total:
          description: Number of related notes returned.
          title: Total
          type: integer
      required:
        - request_id
        - results
        - total
      title: FindRelatedNotesResponseSchema
      type: object
    RelatedNoteItemResponseSchema:
      properties:
        id:
          description: UUID of the related note.
          format: uuid
          title: Id
          type: string
        title:
          description: Current title of the related note.
          title: Title
          type: string
        preview:
          description: |-
            Truncated markdown preview of the related note's current content.
            Use `GET /v2/notes/{note_id}` for the full note body.
          title: Preview
          type: string
        collection_ids:
          description: Accessible collection UUIDs currently associated with the note.
          items:
            format: uuid
            type: string
          title: Collection Ids
          type: array
        collections:
          description: Accessible collection context for the related note.
          items:
            $ref: '#/components/schemas/RelatedNoteCollectionResponseSchema'
          title: Collections
          type: array
        snippet:
          anyOf:
            - type: string
            - type: 'null'
          description: Optional derived note snippet for quick display.
          title: Snippet
        score:
          anyOf:
            - type: number
            - type: 'null'
          description: Similarity score returned by the note vector index.
          title: Score
        created_at:
          description: Creation timestamp for the note in ISO 8601 format.
          format: date-time
          title: Created At
          type: string
        updated_at:
          description: Last modification timestamp for the note in ISO 8601 format.
          format: date-time
          title: Updated At
          type: string
      required:
        - id
        - title
        - preview
        - collection_ids
        - collections
        - created_at
        - updated_at
      title: RelatedNoteItemResponseSchema
      type: object
    RelatedNoteCollectionResponseSchema:
      properties:
        id:
          description: UUID of the collection.
          format: uuid
          title: Id
          type: string
        title:
          description: Current collection title.
          title: Title
          type: string
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Current collection description, if one is set.
          title: Description
        note_count:
          description: Number of active notes currently linked to the collection.
          title: Note Count
          type: integer
        is_shared:
          description: Whether this collection is shared with other accounts.
          title: Is Shared
          type: boolean
        created_at:
          description: Creation timestamp for the collection in ISO 8601 format.
          format: date-time
          title: Created At
          type: string
        updated_at:
          description: Last modification timestamp for the collection in ISO 8601 format.
          format: date-time
          title: Updated At
          type: string
      required:
        - id
        - title
        - note_count
        - is_shared
        - created_at
        - updated_at
      title: RelatedNoteCollectionResponseSchema
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````