Notion API - Public Beta (English)
  1. Comments
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
      • Create a page
      • Retrieve a Page
      • Update Page properties
    • Users
      • List all users
      • Retrieve your token's bot user
      • Retrieve a user
    • Comments
      • Create comment
      • Retrieve comments
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
        POST
      • Retrieve comments
        GET
  1. Comments

Retrieve comments

GET
https://api.notion.com/v1/comments
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.notion.com/v1/comments?block_id=&start_cursor=&page_size=' \
--header 'Notion-Version;'
Response Response Example
200 - Success-Retrieve comments
{
  "object": "list",
  "results": [
    {
      "object": "comment",
      "id": "94cc56ab-9f02-409d-9f99-1037e9fe502f",
      "parent": {
        "type": "page_id",
        "page_id": "5c6a2821-6bb1-4a7e-b6e1-c50111515c3d"
      },
      "discussion_id": "f1407351-36f5-4c49-a13c-49f8ba11776d",
      "created_time": "2022-07-15T16:52:00.000Z",
      "last_edited_time": "2022-07-15T19:16:00.000Z",
      "created_by": {
        "object": "user",
        "id": "9b15170a-9941-4297-8ee6-83fa7649a87a"
      },
      "rich_text": [
        {
          "type": "text",
          "text": {
            "content": "Single comment",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "Single comment",
          "href": null
        }
      ]
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "comment",
  "comment": {}
}

Request

Query Params
block_id
string 
required
start_cursor
string 
optional
page_size
integer 
optional
Header Params
Notion-Version
string 
required

Responses

🟢200OK-Retrieve comments
application/json
Body
object {0}
🟠403Forbidden-Retrieve comments
Modified at 2023-04-28 08:49:29
Previous
Create comment
Built with