> ## Documentation Index
> Fetch the complete documentation index at: https://docs.granola.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search notes

> Search notes by keyword in their titles and summaries, or filter them by participant, folder, space or date. Private notes and transcripts are not searched.

Recent notes can be missing until their summary is generated; use List notes for a complete listing. Keys with the Notes by ID scope get no results.



## OpenAPI

````yaml post /v1/notes/search
openapi: 3.1.0
info:
  title: Granola API
  version: 1.7.0
  description: API for accessing meeting data from Granola
servers:
  - url: https://public-api.granola.ai
    description: Production
security: []
paths:
  /v1/notes/search:
    post:
      summary: Search notes
      description: >-
        Search notes by keyword in their titles and summaries, or filter them by
        participant, folder, space or date. Private notes and transcripts are
        not searched.


        Recent notes can be missing until their summary is generated; use List
        notes for a complete listing. Keys with the Notes by ID scope get no
        results.
      operationId: search_notes
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                keywords:
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 200
                  minItems: 1
                  maxItems: 20
                  description: >-
                    Words to search for in titles and summaries. An entry
                    matches when all its words appear in the title or in the
                    summary, in any order; a note needs only one entry to match.
                participant:
                  type: string
                  minLength: 1
                  maxLength: 200
                  description: >-
                    Only meetings with this person or company on the calendar
                    invite: a name, email, company or domain. It does not match
                    names mentioned in the notes.
                folder_id:
                  type: string
                  pattern: ^[Ff][Oo][Ll]_[a-zA-Z0-9]{14}$
                  description: >-
                    Only notes in this folder and its child folders. Use List
                    folders to find folder IDs.
                space_id:
                  type: string
                  pattern: ^[Ss][Pp][Aa]_[a-zA-Z0-9]{14}$
                  description: >-
                    Only notes in this space and its folders. Use List spaces to
                    find space IDs. Combines with folder_id.
                  example: spa_8kTq2mWxLp4Rz7
                from_date:
                  anyOf:
                    - type: string
                      format: date
                    - type: string
                      format: date-time
                  description: >-
                    Only meetings that started at or after this date or UTC
                    timestamp. A date means midnight UTC. Notes without a
                    calendar event use their creation time.
                  examples:
                    - '2026-01-27'
                    - '2026-01-27T15:30:00Z'
                to_date:
                  anyOf:
                    - type: string
                      format: date
                    - type: string
                      format: date-time
                  description: >-
                    Only meetings that started at or before this date or UTC
                    timestamp. A date means midnight UTC at the start of that
                    day, so it leaves out meetings later that day.
                  examples:
                    - '2026-01-27'
                    - '2026-01-27T15:30:00Z'
                updated_after:
                  anyOf:
                    - type: string
                      format: date
                    - type: string
                      format: date-time
                  description: >-
                    Only notes whose content or summary changed after this date
                    or UTC timestamp. A date means midnight UTC.
                  examples:
                    - '2026-01-27'
                    - '2026-01-27T15:30:00Z'
                page_size:
                  type: integer
                  minimum: 1
                  maximum: 30
                  default: 10
                  description: Maximum number of notes to return per page
                  example: 10
                cursor:
                  type: string
                  minLength: 1
                  maxLength: 2048
                  description: >-
                    The cursor from the previous response, to fetch the next
                    page. Send it alone or with page_size. Cursors expire after
                    15 minutes.
              additionalProperties: false
            examples:
              keywords:
                summary: Find notes with a calendar participant from Acme
                value:
                  keywords:
                    - budget review
                    - renewal
                  participant: acme.com
                  page_size: 10
              nextPage:
                summary: Continue with the cursor from the previous response
                value:
                  cursor: CURSOR_FROM_PREVIOUS_RESPONSE
                  page_size: 10
              browse:
                summary: List notes newest first, with no filters
                value: {}
      responses:
        '200':
          description: Matching notes and whether there are more pages
          content:
            application/json:
              schema:
                type: object
                properties:
                  notes:
                    type: array
                    items:
                      allOf:
                        - $ref: '#/components/schemas/NoteSummary'
                        - type: object
                          properties:
                            meeting_at:
                              type: string
                              format: date-time
                              description: >-
                                When the meeting started according to the
                                calendar, or the note's creation time if it has
                                no calendar event.
                              example: '2026-01-27T15:30:00Z'
                          required:
                            - meeting_at
                  hasMore:
                    type: boolean
                    description: >-
                      Whether there is another page. A page can hold fewer notes
                      than page_size, or none, and still have more, so keep
                      requesting with cursor until this is false.
                  cursor:
                    type:
                      - string
                      - 'null'
                    description: The next-page cursor, or null when hasMore is false.
                  completion_status:
                    type: string
                    enum:
                      - more_available
                      - exhausted
                      - incomplete
                    description: >-
                      more_available: fetch the next page with cursor.
                      exhausted: there are no more matches. incomplete: the
                      search stopped after examining 10,000 notes without
                      finishing; narrow it and search again.
                required:
                  - notes
                  - hasMore
                  - cursor
                  - completion_status
        '400':
          description: Invalid request body, or an expired cursor
        '401':
          description: Unauthorized - Invalid API key
        '404':
          description: >-
            Folder or space not found, or the API key's access scope cannot use
            this endpoint
        '429':
          description: Rate limited
        '500':
          description: Search unavailable
      security:
        - ApiKeyAuth: []
components:
  schemas:
    NoteSummary:
      type: object
      properties:
        id:
          type: string
          pattern: ^not_[a-zA-Z0-9]{14}$
          description: The ID of the note
          example: not_1d3tmYTlCICgjy
        object:
          type: string
          enum:
            - note
          description: The object type of the note
        title:
          type:
            - string
            - 'null'
          description: The title of the note
          example: Quarterly yoghurt budget review
        owner:
          $ref: '#/components/schemas/User'
        created_at:
          type: string
          format: date-time
          description: The creation time of the note
          example: '2026-01-27T15:30:00Z'
        updated_at:
          type: string
          format: date-time
          description: The last update time of the note
          example: '2026-01-27T16:45:00Z'
        deleted_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When the note was deleted, or null if it has not been. Only keys
            with access to all workspace notes can see deleted notes.
          example: null
      required:
        - id
        - object
        - title
        - owner
        - created_at
        - updated_at
        - deleted_at
    User:
      type: object
      properties:
        name:
          type:
            - string
            - 'null'
          description: The name of the user
          example: Oat Benson
        email:
          type: string
          format: email
          description: The email of the user
          example: oat@granola.ai
      required:
        - name
        - email
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.