Notion/listComments

Online calls unavailable · details below

NotionNotion collaborative workspace API

GET/v1/comments

List comments

Lists comments on a block or page.

Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.

Request

operationId: listComments
Server: https://api.notion.com
Authentication: bearerAuth, basicAuth

Request parameters

`block_id`

queryidRequestrequired

`start_cursor`

querystring

Pagination start cursor (opaque).

example content

`page_size`

queryinteger

Number of results per page.

`Notion-Version`

headerstringrequired

API version date for the request; the current latest version is 2026-03-11.

2026-03-11

Responses

`200`

objectapplication/json

Request succeeded.

Properties: commenthas_morenext_cursorobjectrequest_statusresultstype

`400`

error_api_400application/json

Request parameters are invalid.

`401`

error_api_401application/json

Unauthenticated or the token is invalid.

`403`

error_api_403application/json

Access to the resource is forbidden.

`404`

error_api_404application/json

The requested resource was not found.

`406`

error_api_406application/json

The request cannot be represented as requested.

`409`

error_api_409application/json

The request conflicts with the current state of the resource.

`429`

error_api_429application/json

Rate limited; retry after Retry-After.

`500`

error_api_500application/json

Upstream internal error.

`503`

error_api_503application/json

Upstream service temporarily unavailable.

`504`

error_api_504application/json

Upstream gateway timeout.

`529`

error_api_529application/json

Upstream overloaded; retry like a 429.

{
  "comment": {},
  "has_more": true,
  "object": "list",
  "request_status": {
    "incomplete_reason": "query_result_limit_reached",
    "type": "complete"
  },
  "results": {
    "attachments": [
      {}
    ],
    "created_by": {
      "id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
      "object": "user"
    },
    "created_time": "2026-03-11T00:00:00.000Z",
    "discussion_id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
    "display_name": {
      "resolved_name": "example content",
      "type": "custom"
    },
    "id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
    "last_edited_time": "2026-03-11T00:00:00.000Z",
    "object": "comment"
  },
  "type": "comment"
}