GRgranola

List notes

Changed on
get/v1/notes

Request

  • Base URL
    https://public-api.granola.ai
  • Auth
    HTTP bearer

Query parameters

string date
OR
string date-time
string date
OR
string date-time
string date
OR
string date-time
folder_idstring

Return notes in this folder and any of its child folders. Folder IDs are case-insensitive. Use the list folders endpoint to discover folder IDs.

Example:fol_4y6LduVdwSKC27
cursorstring

The cursor to continue from

Example:eyJjcmVkZW50aWFsfQ==
page_sizeinteger

Maximum number of notes to return per page

Example:10
space_idstring

Return notes in this space. Space IDs are case-insensitive. Use the list spaces endpoint to discover space IDs.

Example:spa_8kTq2mWxLp4Rz7

Response

List of notes

hasMoreboolean required

Whether there are more notes to fetch

cursorstring nullable required

The cursor to continue from

Example response

{
  "notes": [
    {
      "id": "not_1d3tmYTlCICgjy",
      "title": "Quarterly yoghurt budget review",
      "owner": {
        "name": "Oat Benson",
        "email": "oat@granola.ai"
      },
      "created_at": "2026-01-27T15:30:00Z",
      "updated_at": "2026-01-27T16:45:00Z"
    }
  ],
  "hasMore": true,
  "cursor": "eyJjcmVkZW50aWFsfQ=="
}

Changes

  • 480617fbc624Revision changes
    • warning

      changed the pattern of the query request parameter folder_id from ^fol_[a-zA-Z0-9]{14}$ to ^[Ff][Oo][Ll]_[a-zA-Z0-9]{14}$

    • warning

      changed the pattern of the query request parameter space_id from ^spa_[a-zA-Z0-9]{14}$ to ^[Ss][Pp][Aa]_[a-zA-Z0-9]{14}$

  • 8c6132290484Revision changes
    • info

      added the new optional query request parameter space_id