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.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Maximum number of notes in this page. Use smaller values for lower latency. Default is 50; valid range is 1 to 100.
1 <= x <= 100Opaque cursor from a previous list response.
Omit for the first page.
IMPORTANT: Reuse with the same filters and order_by settings.
Sort key for pagination boundaries.
Use updated_at (default) for recency feeds.
Use created_at for creation-order views.
created_at, updated_at Optional collection filter by UUID. When set, only notes linked to this collection are returned.
Optional inclusive lower bound for note creation time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
Optional inclusive upper bound for note creation time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
Optional inclusive lower bound for note update time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
Optional inclusive upper bound for note update time (ISO 8601).
The timestamp must include a timezone offset such as Z or +01:00.
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.
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.
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.
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.
When true, include full markdown content for each returned note. IMPORTANT: This increases payload size and can increase latency.
Response
OK
Identifier for this API request. Useful for tracing and support.
Page of note results matching the requested filters and sort.
Total number of matching notes before pagination is applied.
Opaque cursor for the next page of results. Omitted when there are no more results.