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
        POST
      • Retrieve comments
        GET
    • 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
      • Retrieve comments
  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
{
    "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
application/json
Body
object {0}
🟠403Forbidden
Previous
Create comment
Next
Search optimizations and limitations
Built with