Skip to main content
GET
List Messages Endpoint
Returns all messages in a thread in chronological order. Use this after a run completes to read the agent’s response. When the agent used file search, each retrieved chunk’s source tracing fields are appended to the assistant message content: chunk_id, page, lines, and section. Use chunk_id to call the chunk endpoint for full Markdown provenance and the file_id of the source document.

Authorizations

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Headers

x-team-id
string | null

Path Parameters

thread_id
string
required

Query Parameters

limit
integer
default:20
Required range: x >= 0
order
enum<string>
default:desc

Options for order query param in list endpoints.

Available options:
asc,
desc
offset
integer
default:0
Required range: x >= 0
include_parts
boolean
default:false
expand_part_payloads
boolean
default:false

Response

Success

thread_id
string
required
role
string
required
content
required
id
string
object
string
default:thread.message
created_at
string<date-time>
parts
(MessageTextPart · object | MessageReasoningPart · object | MessageFilePart · object | MessageDataPart · object | MessageToolCallPart · object | MessageToolErrorPart · object | MessageToolResultPart · object)[] | null

A text part persisted alongside a thread message.

agent_id
string | null
run_id
string | null
meta_data
Meta Data · object
Last modified on July 31, 2026