> ## 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. # List 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`. ## OpenAPI ````yaml GET /v2/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: get: tags: - external - external-v2 summary: List Notes description: >- 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`. operationId: app_src_api_routes_external_v2_notes_views_list_notes parameters: - in: query name: limit schema: anyOf: - maximum: 100 minimum: 1 type: integer - type: 'null' default: 50 description: |- Maximum number of notes in this page. Use smaller values for lower latency. Default is 50; valid range is 1 to 100. title: Limit required: false description: |- Maximum number of notes in this page. Use smaller values for lower latency. Default is 50; valid range is 1 to 100. - in: query name: page schema: anyOf: - type: string - type: 'null' description: |- Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same filters and `order_by` settings. title: Page required: false description: |- Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same filters and `order_by` settings. - in: query name: order_by schema: allOf: - enum: - created_at - updated_at title: NoteListOrderBy type: string default: updated_at description: |- Sort key for pagination boundaries. Use `updated_at` (default) for recency feeds. Use `created_at` for creation-order views. required: false description: |- Sort key for pagination boundaries. Use `updated_at` (default) for recency feeds. Use `created_at` for creation-order views. - in: query name: collection_id schema: anyOf: - type: string format: uuid - type: 'null' description: |- Optional collection filter by UUID. When set, only notes linked to this collection are returned. title: Collection Id required: false description: |- Optional collection filter by UUID. When set, only notes linked to this collection are returned. - in: query name: filter_by_created_after schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive lower bound for note creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Created After required: false description: >- Optional inclusive lower bound for note creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. - in: query name: filter_by_created_before schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive upper bound for note creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Created Before required: false description: >- Optional inclusive upper bound for note creation time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. - in: query name: filter_by_updated_after schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive lower bound for note update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Updated After required: false description: >- Optional inclusive lower bound for note update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. - in: query name: filter_by_updated_before schema: anyOf: - type: string format: date-time - type: 'null' description: >- Optional inclusive upper bound for note update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. title: Filter By Updated Before required: false description: >- Optional inclusive upper bound for note update time (ISO 8601). The timestamp must include a timezone offset such as `Z` or `+01:00`. - in: query name: contains_open_tasks schema: default: false description: >- 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. title: Contains Open Tasks type: boolean required: false description: >- 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. - in: query name: contains_tasks schema: default: false description: >- 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. title: Contains Tasks type: boolean required: false description: >- 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. - in: query name: contains_images schema: default: false description: >- 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. title: Contains Images type: boolean required: false description: >- 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. - in: query name: contains_files schema: default: false description: >- 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. title: Contains Files type: boolean required: false description: >- 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. - in: query name: include_note_content schema: default: false description: |- When true, include full markdown content for each returned note. IMPORTANT: This increases payload size and can increase latency. title: Include Note Content type: boolean required: false description: |- When true, include full markdown content for each returned note. IMPORTANT: This increases payload size and can increase latency. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/NoteListResponseSchema' x-codeSamples: - lang: bash label: cURL source: |- curl "https://api.mem.ai/v2/notes?limit=20" \ --header "Authorization: Bearer $MEM_API_KEY" components: schemas: NoteListResponseSchema: example: next_page: >- eyJpZCI6IjAxOGY4ZDBkLTVhM2MtN2FmYy04MzIxLTJmNmY2ZTBmZWZhYiIsIm9yZGVyX2J5IjoidXBkYXRlZF9hdCIsInJlcXVlc3RfZmluZ2VycHJpbnQiOiJkZjk4MDI5YjhhZGI0M2Q4NmI5YTRkYjQ3ZTZhYWE4NjkyZjUzZGFiZDQ4ZDg0MjYxZWI2YjY2MDVhODI2N2Q4IiwidmFsdWUiOiIyMDI1LTA1LTA0VDE0OjIwOjExWiJ9 request_id: api-request-018f8d0d-5a3c-7afc-8321-2f6f6e0fefab results: - audio_recording_ids: - 78ff64bc-09e3-4fd7-a4b9-53c258f35619 collection_ids: - 59508b41-8770-4855-aa37-302b1e09aee7 - 026b426c-14fb-4f22-8d98-7a9121bfaec8 content: | # Weekly Planning ## Priorities - Customer interviews - Ship timeline view created_at: '2025-05-01T10:05:45Z' id: 018f8d0d-5a3c-7afc-8321-2f6f6e0fefab snippet: Quarterly kickoff prep title: Weekly Planning updated_at: '2025-05-04T14:20:11Z' total: 12 properties: request_id: description: Identifier for this API request. Useful for tracing and support. title: Request Id type: string results: description: Page of note results matching the requested filters and sort. items: $ref: '#/components/schemas/NoteListItemResponseSchema' title: Results type: array total: description: Total number of matching notes before pagination is applied. title: Total type: integer next_page: anyOf: - type: string - type: 'null' description: |- Opaque cursor for the next page of results. Omitted when there are no more results. title: Next Page required: - request_id - results - total title: NoteListResponseSchema type: object NoteListItemResponseSchema: properties: id: description: UUID of the note. format: uuid title: Id type: string title: description: Current title of the note. title: Title type: string content: anyOf: - type: string - type: 'null' description: |- Full markdown content for the note. Included only when `include_note_content=true` is requested. title: Content collection_ids: description: Collection UUIDs currently associated with the note. items: type: string format: uuid title: Collection Ids type: array audio_recording_ids: description: Audio Recording UUIDs currently associated with the note. items: type: string format: uuid title: Audio Recording Ids type: array snippet: anyOf: - type: string - type: 'null' description: >- Optional derived preview text for quick display and ranking context. It may be truncated and is not guaranteed to contain full note context. title: Snippet 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 - collection_ids - audio_recording_ids - created_at - updated_at title: NoteListItemResponseSchema type: object securitySchemes: bearerAuth: type: http scheme: bearer ````