Skip to main content
GET
/
v1
/
threads
/
{thread_id}
/
messages
List thread messages
curl --request GET \
  --url https://api.notion.com/v1/threads/{thread_id}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Notion-Version: <notion-version>'
{
  "object": "<string>",
  "type": "<string>",
  "results": [
    {
      "object": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "content": "<string>",
      "created_time": "2023-11-07T05:31:56Z",
      "parent": {
        "type": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "attachments": [
        {
          "name": "<string>",
          "content_type": "<string>",
          "url": "<string>",
          "expiry_time": "2023-11-07T05:31:56Z"
        }
      ],
      "content_parts": [
        {
          "type": "<string>",
          "text": "<string>"
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}
This is an internal/undocumented endpoint. It is not part of the public API and may change without notice. Do not rely on this endpoint for production connections.
Error steps from the agent (such as inference failures or tool errors) are surfaced as messages with role: "agent", where the content field contains the error description.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Notion-Version
enum<string>
required

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

Available options:
2026-03-11

Path Parameters

​
thread_id
string
required

The ID of the thread.

Query Parameters

​
verbose
boolean

Whether to include verbose agent output (thinking, tool calls, tool results). Defaults to true.

​
role
enum<string>

Filter messages by role (user or agent).

Available options:
user,
agent
​
start_cursor
string

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_size
integer

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

Required range: 1 <= x <= 100

Response

​
object
string
required

Always list

Allowed value: "list"
​
type
string
required

Always thread_message

Allowed value: "thread_message"
​
results
object[]
required
Maximum array length: 100
​
has_more
boolean
required
​
next_cursor
string | null
required