---
title: "List Notes"
method: GET
path: "/v2/notes"
tags: ["external", "external-v2"]
---

# List Notes

`GET /v2/notes`

List notes visible to the authenticated caller with cursor pagination.
When multiple `contains_*` fields are true, a note may match any of them.
Results are ordered by `order_by` and return `next_page` when additional rows are available.
For relevance-ranked retrieval by query, use `POST /v2/notes/search`.

## Query parameters

- `limit` integer, nullable — Maximum number of notes in this page. Use smaller values for lower latency. Default is 50; valid range is 1 to 100.
- `page` string, nullable — Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same filters and `order_by` settings.
- `order_by` 'created_at' | 'updated_at' — Sort key for pagination boundaries. Use `updated_at` (default) for recency feeds. Use `created_at` for creation-order views.
- `collection_id` string, uuid, nullable — Optional collection filter by UUID. When set, only notes linked to this collection are returned.
- `filter_by_created_after` string, date-time, nullable — Optional inclusive lower bound for note creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
- `filter_by_created_before` string, date-time, nullable — Optional inclusive upper bound for note creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
- `filter_by_updated_after` string, date-time, nullable — Optional inclusive lower bound for note update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
- `filter_by_updated_before` string, date-time, nullable — Optional inclusive upper bound for note update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`.
- `contains_open_tasks` boolean — When true, include notes that contain at least one open task item. When multiple `contains_*` fields are true, notes matching any selected filter may be returned.
- `contains_tasks` boolean — When true, include notes that contain at least one task item (open or closed). When multiple `contains_*` fields are true, notes matching any selected filter may be returned.
- `contains_images` boolean — When true, include notes that contain image media (including image and GIF kinds). When multiple `contains_*` fields are true, notes matching any selected filter may be returned.
- `contains_files` boolean — When true, include notes that contain file-like attachments (including file and PDF kinds). When multiple `contains_*` fields are true, notes matching any selected filter may be returned.
- `include_note_content` boolean — When true, include full markdown content for each returned note. IMPORTANT: This increases payload size and can increase latency.

## Response `200`

OK

- NoteListResponseSchema
  - `next_page` string, nullable — Opaque cursor for the next page of results. Omitted when there are no more results.
  - `request_id` string, required — Identifier for this API request. Useful for tracing and support.
  - `results` NoteListItemResponseSchema[], required — Page of note results matching the requested filters and sort.
    - `audio_recording_ids` string[], required — Audio Recording UUIDs currently associated with the note.
    - `collection_ids` string[], required — Collection UUIDs currently associated with the note.
    - `content` string, nullable — Full markdown content for the note. Included only when `include_note_content=true` is requested.
    - `created_at` string, date-time, required — Creation timestamp for the note in ISO 8601 format.
    - `id` string, uuid, required — UUID of the note.
    - `snippet` string, nullable — Optional derived preview text for quick display and ranking context. It may be truncated and is not guaranteed to contain full note context.
    - `title` string, required — Current title of the note.
    - `updated_at` string, date-time, required — Last modification timestamp for the note in ISO 8601 format.
  - `total` integer, required — Total number of matching notes before pagination is applied.

---

[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)