get https://api.productboard.com/v2/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
pageCursorparameter to paginate through results.
To discover available fields use the
/v2/notes/configurationendpoint.
Date/Time Filtering
You can filter notes by creation or update timestamps using ISO-8601 date-time format:
- Use
createdFromandcreatedToto filter by creation date (inclusive bounds) - Use
updatedFromandupdatedToto 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:
archived | processed | Result |
|---|---|---|
| – | – | All notes |
true | true | None |
true | false | Archived |
false | true | Processed |
false | false | Unprocessed |
true | – | Archived |
false | – | Processed + unprocessed |
| – | true | Processed |
| – | false | Archived + unprocessed |
Note: Archived notes always return
processed: falsein the API response, regardless of their actual processing state. This is a known limitation of the system.
