Sign in

v1

latestOpenAPI 3.1.02026-07-2664485505.4 KB
Comments

List comments

get/v1/comments

Query parameters

block_idstring required
start_cursorstring

If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.

page_sizeinteger

The number of items from the full list desired in the response. Maximum: 100

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

object'list' required

Always list

next_cursorstring uuid required
has_moreboolean required
type'comment' required

Always comment

commentEmptyObject required

Example response

{
  "results": [
    {
      "rich_text": [
        {
          "text": {
            "link": {
              "url": "https://www.notion.com"
            }
          }
        }
      ]
    }
  ]
}