List thread events

List event history for one Thread in a Forward Session.

Request headers

Header	Required	Description
Authorization	Yes	`Bearer <PAT>`

Path parameters

Parameter	Type	Required	Description
`session_id`	string	Yes	Session ID.
`thread_id`	string	Yes	Thread ID.

Query parameters

Parameter	Type	Required	Default	Description
`limit`	integer	No	20	Items per page. Maximum 100.
`after_id`	string	No	-	Returns events after the given Event ID.
`before_id`	string	No	-	Returns events before the given Event ID.
`order`	string	No	asc	Sort order: `asc` or `desc`.
`type`	string	No	-	Filter by Event type. Comma-separated values are supported.
`types[]`	string	No	-	Array-style Event type filter.
`include_tool_calls`	boolean	No	true	Include tool call events.
`include_thinking`	boolean	No	true	Include thinking events.

Example request

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/threads/sthr_child_xxx/events' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "evt_xxx",
      "type": "agent.message",
      "session_id": "sess_xxx",
      "session_thread_id": "sthr_child_xxx",
      "content": [
        {
          "type": "text",
          "text": "The child task is complete."
        }
      ],
      "processed_at": "2026-06-22T11:05:00Z"
    }
  ],
  "first_id": "evt_xxx",
  "last_id": "evt_xxx",
  "has_more": false
}

Response fields

Field	Type	Description
`data`	array	Event objects on the current page.
`first_id`	string\|null	ID of the first event on this page.
`last_id`	string\|null	ID of the last event on this page.
`has_more`	boolean	Whether more records remain.

Thread Event fields

Each item in data[] uses the same filtered Forward Event object as List Session Events. Thread-related events include session_thread_id in the public payload. See List Session Events for the complete Event type dispatch matrix.

Errors

HTTP	Type	Code	Trigger
400	`invalid_request_error`	`invalid_event_cursor`	Cursor does not belong to this Thread.
400	`invalid_request_error`	`invalid_pagination`	Pagination parameters are invalid.
404	`not_found_error`	`session_not_found`	Session does not exist.
404	`not_found_error`	`thread_not_found`	Thread does not exist.
401	`authentication_error`	`authentication_required`	PAT invalid or expired.

Notes

Thread Event responses use the same stable payload whitelist as Session Event responses.
Session-level Event Stream includes all Thread events; this endpoint returns only events for the specified Thread.

​Request headers

​Path parameters

​Query parameters

​Example request

​Example response

​Response fields

​Thread Event fields

​Errors

​Notes

​Related