List notes

Retrieves a list of notes from your workspace.

  • Notes are sorted by creation date, newest first.
  • You can filter results using query parameters like archived, processed, owner[email], source[recordId], or date/time ranges.
  • Use the pageCursor parameter to paginate through results.

To discover available fields use the /v2/notes/configuration 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:

archivedprocessedResult
All notes
truetrueNone
truefalseArchived
falsetrueProcessed
falsefalseUnprocessed
trueArchived
falseProcessed + unprocessed
trueProcessed
falseArchived + unprocessed

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.

Language
Credentials
Header
Click Try It! to start a request and see the response here!