List Threads

Call Create session first and replace the example session ID with its returned ID.

GET /anthropic/v1/sessions/{session_id}/threads◐ Partial

Request parameters

session_idstring必填
path: Session ID (path or query parameter).
limitnumber可选
query: Maximum number of items per page.
pagestring可选
query: Pagination cursor taken from the previous response's next_page.

Returns

200

Returns the primary thread and every child thread in created_at order. Thread ids use sthr_ plus the owning session suffix; children reference the primary parent_thread_id and retain the parent session_id. agent describes the actual running definition; built-in types use their type name and null for unregistered id/version. Archived children have status terminated and archived_at. stats/usage remain null without thread-level tracking.

Errors follow the Claude Managed Agents format — see error codes

Response

HTTP 200

Successful response

application/json

Name	Type	Description
data	array<object>
data[].id	string	Unique identifier for this thread.
data[].agent	object	The resolved agent a `session_thread` runs.
data[].archived_at	null \| string	A timestamp in RFC 3339 format
data[].created_at	string	A timestamp in RFC 3339 format
data[].parent_thread_id	null \| string	Parent thread that spawned this thread. Null for the primary thread.
data[].session_id	string	The session this thread belongs to.
data[].stats	null \| object	Timing statistics for a session thread.
data[].status	string	SessionThreadStatus enum
data[].type	string
data[].updated_at	string	A timestamp in RFC 3339 format
data[].usage	null \| object	Cumulative token usage for a session thread across all turns.
next_page	string \| null