v32

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-312881,4162.7 MB

List ChatKit thread items

List items that belong to a ChatKit thread.

get/chatkit/threads/{thread_id}/items

Path parameters

thread_idstring required
Example:cthr_123

Identifier of the ChatKit thread whose items are requested.

Query parameters

limitinteger

Maximum number of thread items to return. Defaults to 20.

order'asc' | 'desc'

Sort order for results by creation time. Defaults to desc.

afterstring

List items created after this thread item ID. Defaults to null for the first page.

List items created after this thread item ID. Defaults to null for the first page.

beforestring

List items created before this thread item ID. Defaults to null for the newest results.

List items created before this thread item ID. Defaults to null for the newest results.

Response

Success

object'list' required

The type of object returned, must be list.

first_idstring nullable required

The ID of the first item in the list.

last_idstring nullable required

The ID of the last item in the list.

has_moreboolean required

Whether there are more items available.