Retrieve a comment

curl -X GET \
  'https://api.notion.com/v1/comments/126a28216bb14a7eb6e1c50111515c3d' \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H 'Notion-Version: 2022-06-28' \
  -H 'Content-Type: application/json'

{
  "Result": {
    "value": "{\n\t\"object\": \"comment\",\n\t\"id\": \"249911a-125e-803e-a164-001cf338b8ec\",\n\t\"parent\": {\n\t\t\"type\": \"block_id\",\n\t\t\"block_id\": \"247vw11a-125e-8053-8e73-d3b3ed4f5768\"\n\t},\n\t\"discussion_id\": \"1mv7b911a-125e-80df-8c9e-001c179f63ef\",\n\t\"created_time\": \"2025-08-06T20:36:00.000Z\",\n\t\"last_edited_time\": \"2025-08-06T20:36:00.000Z\",\n\t\"created_by\": {\n\t\t\"object\": \"user\",\n\t\t\"id\": \"2092e755-4912-81f0-98dd-0002ad4ec952\"\n\t},\n\t\"rich_text\": [\n\t\t{\n\t\t\t\"type\": \"text\",\n\t\t\t\"text\": {\n\t\t\t\t\"content\": \"hello there\",\n\t\t\t\t\"link\": null\n\t\t\t},\n\t\t\t\"annotations\": {\n\t\t\t\t\"bold\": false,\n\t\t\t\t\"italic\": false,\n\t\t\t\t\"strikethrough\": false,\n\t\t\t\t\"underline\": false,\n\t\t\t\t\"code\": false,\n\t\t\t\t\"color\": \"default\"\n\t\t\t},\n\t\t\t\"plain_text\": \"hello there\",\n\t\t\t\"href\": null\n\t\t}\n\t],\n\t\"display_name\": {\n\t\t\"type\": \"integration\",\n\t\t\"resolved_name\": \"int\"\n\t}\n}"
  }
}

Retrieves a Comment object from its comment_id.

Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.

Reminder: Turn on integration comment capabilities

Integration capabilities for reading and inserting comments are off by default.

This endpoint requires an integration to have read comment capabilities. Attempting to call this endpoint without read comment capabilities will return an HTTP response with a 403 status code.

For more information on integration capabilities, see the capabilities guide. To update your integration settings, visit the integration dashboard.

Path parameters

comment_idstringRequired

Response

200

objectstringOptional

idstringOptional

parentobjectOptional

discussion_idstringOptional

created_timestringOptional

last_edited_timestringOptional

created_byobjectOptional

rich_textlist of objectsOptional

display_nameobjectOptional

Errors

403

Forbidden Error

Errors

Path parameters

Headers

Response

Errors