Skip to main content
GET
List Runs Endpoint

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

Response

Success

id
string
required
created_at
string<date-time>
required
agent_id
string
required
thread_id
string
required
status
enum<string>
required

Available status for a run.

Available options:
queued,
running,
completed,
failed,
canceled,
cancelled
model
string
required
temperature
number
required
top_p
number
required
parallel_tool_calls
boolean
required
object
string
default:thread.run
is_active
boolean
default:false
started_at
string<date-time> | null
expires_at
string<date-time> | null
cancelled_at
string<date-time> | null
failed_at
string<date-time> | null
completed_at
string<date-time> | null
instructions
string | null
tools
Tools · object[]
meta_data
Meta Data · object
usage
RunUsage · object | null

Aggregated usage metrics for a complete run execution.

Tracks token consumption for both prompts and completions.

max_completion_tokens
integer | null
truncation_strategy
Truncation Strategy · object
response_format
default:auto
tool_choice
default:auto
Last modified on July 31, 2026