---
title: "Query meeting notes"
method: POST
path: "/v1/blocks/meeting_notes/query"
tags: ["Meeting notes"]
---

# Query meeting notes

`POST /v1/blocks/meeting_notes/query`

## Headers

- `Notion-Version` '2026-03-11', required

## Request body

- object
  - `filter` object — Optional filter for querying meeting notes. Supports combinator (and/or) and property filters on title, attendees, created_time, created_by, last_edited_time, last_edited_by.
    - `operator` 'and' | 'or', required — Operator for combinator filters.
    - `filters` union[] — Nested filters; each may be a combinator (and/or) or property filter.
      - union
        - object
          - `property` 'title' | 'attendees' | 'created_time' | 'created_by' | 'last_edited_time' | 'last_edited_by' | 'notion://meeting_notes/attendees', required — Which meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility.
          - `filter` union, required — The comparison to apply. Use the arm matching the property's type.
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
        - object
          - `operator` 'and' | 'or', required — Whether every child must match, or any of them.
          - `filters` object[], required — The conditions in this group. A group with no conditions matches nothing, so send at least one.
            - `property` 'title' | 'attendees' | 'created_time' | 'created_by' | 'last_edited_time' | 'last_edited_by' | 'notion://meeting_notes/attendees', required — Which meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility.
            - `filter` union, required — The comparison to apply. Use the arm matching the property's type.
              - …
  - `sort` object[] — Optional sort order for the results. Each entry specifies a property name and direction.
    - `property` 'title' | 'attendees' | 'created_time' | 'created_by' | 'last_edited_time' | 'last_edited_by', required — Property name to sort by.
    - `direction` 'ascending' | 'descending', required — Sort direction. Must be 'ascending' or 'descending'.
  - `limit` integer — Maximum number of results to return. Defaults to 50.

## Response `200`

- object
  - `results` object[], required — Meeting note transcription block objects.
    - `object` 'block', required — Always "block".
    - `id` string, uuid, required
    - `type` 'meeting_notes', required — Always "meeting_notes".
    - `meeting_notes` object, required — Meeting note content fields.
      - `title` RichTextItemResponse[] — Title of the meeting note as rich text.
        - union
          - object
            - `plain_text` string, required — The plain text content of the rich text object, without any styling.
            - `href` string, nullable, required — A URL that the rich text object links to or mentions.
            - `annotations` AnnotationResponse, required
              - …
            - `type` 'text', required — Always `text`
            - `text` object, required — If a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.
              - …
          - object
            - `plain_text` string, required — The plain text content of the rich text object, without any styling.
            - `href` string, nullable, required — A URL that the rich text object links to or mentions.
            - `annotations` AnnotationResponse, required
              - …
            - `type` 'mention', required — Always `mention`
            - `mention` union, required — Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.
              - …
          - object
            - `plain_text` string, required — The plain text content of the rich text object, without any styling.
            - `href` string, nullable, required — A URL that the rich text object links to or mentions.
            - `annotations` AnnotationResponse, required
              - …
            - `type` 'equation', required — Always `equation`
            - `equation` object, required — Notion supports inline LaTeX equations as rich text objects with a type value of `equation`.
              - …
      - `status` 'transcription_not_started' | 'transcription_paused' | 'transcription_in_progress' | 'transcription_failed' | 'summary_in_progress' | 'notes_ready' — Current processing status of the meeting note transcription.
      - `children` object — Block IDs for each tab (summary, notes, transcript).
        - `summary_block_id` string, uuid
        - `notes_block_id` string, uuid
        - `transcript_block_id` string, uuid
      - `calendar_event` object — Calendar event metadata associated with this meeting note.
        - `start_time` string, required — ISO-8601 start time of the calendar event.
        - `end_time` string, required — ISO-8601 end time of the calendar event.
        - `attendees` IdResponse[] — List of attendee user IDs.
      - `recording` object — Start and end times of the actual recording.
        - `start_time` string — ISO-8601 timestamp when the recording started.
        - `end_time` string — ISO-8601 timestamp when the recording ended.
    - `created_time` string, required — ISO-8601 timestamp when this meeting note was created.
    - `last_edited_time` string, required — ISO-8601 timestamp when this meeting note was last edited.
    - `created_by` PartialUserObjectResponse, required
      - `id` string, uuid, required
      - `object` 'user', required — Always `user`
    - `last_edited_by` PartialUserObjectResponse, required
      - `id` string, uuid, required
      - `object` 'user', required — Always `user`
    - `has_children` boolean, required — Whether this block has child blocks.
    - `in_trash` boolean, required — Whether this meeting note is in the trash.
  - `has_more` boolean, required — Whether additional results exist beyond the returned limit.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/dee5763763b0/schema)