Retrieves a list of notes from your workspace.

Without the members:pii:read scope, owner and creator email fields are returned as [redacted]. Filtering by owner[email] or creator[email] requires the members:pii:read scope.

• Notes are sorted by creation date, newest first.
• You can filter results using query parameters like archived, processed, owner[email], creator[email], source[recordId], or date/time ranges.
• Use the pageCursor parameter to paginate through results.
• Use the fields query parameter to optimize response size (default: all non-null fields, use fields=all to include null values, or fields=name,tags for specific fields).

To discover available fields use the /v2/notes/configurations endpoint.

Date/Time Filtering

You can filter notes by creation or update timestamps using ISO-8601 date-time format:

• Use createdFrom and createdTo to filter by creation date (inclusive bounds)
• Use updatedFrom and updatedTo to filter by update date (inclusive bounds)
• All date/time filters can be combined with each other and with other filters
• Date ranges must be valid (From <= To) or a 400 error will be returned

Filtering combinations

Some combinations of the archived and processed flags result in empty or unexpected results. Use the following table to understand which notes are returned based on the filter values:

Note: Archived notes always return processed: false in the API response, regardless of their actual processing state. This is a known limitation of the system.