LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
  • Client
  • AsyncClient
  • Run Helpers
  • Run Trees
  • Evaluation
  • Schemas
  • Utilities
  • Wrappers
  • Anonymizer
  • Testing
  • Expect API
  • Middleware
  • Pytest Plugin
  • Deployment SDK
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

OverviewClientAsyncClientRun HelpersRun TreesEvaluationSchemasUtilitiesWrappersAnonymizerTestingExpect APIMiddlewarePytest PluginDeployment SDK
Language
Theme
Pythonlangsmith_openapi_clientresourcestracesTracesResourcelist_runs
Method●Since v0.10

list_runs

Copy
list_runs(
  self,
  trace_id: str,
  *,
  project_id: str
View source on GitHub
,
filter
:
str
|
Omit
=
omit
,
max_start_time
:
Union
[
str
,
datetime
]
|
Omit
=
omit
,
min_start_time
:
Union
[
str
,
datetime
]
|
Omit
=
omit
,
selects
:
List
[
Literal
[
'ID'
,
'NAME'
,
'RUN_TYPE'
,
'STATUS'
,
'START_TIME'
,
'END_TIME'
,
'LATENCY_SECONDS'
,
'FIRST_TOKEN_TIME'
,
'ERROR'
,
'ERROR_PREVIEW'
,
'EXTRA'
,
'METADATA'
,
'EVENTS'
,
'INPUTS'
,
'INPUTS_PREVIEW'
,
'OUTPUTS'
,
'OUTPUTS_PREVIEW'
,
'MANIFEST'
,
'PARENT_RUN_IDS'
,
'PROJECT_ID'
,
'TRACE_ID'
,
'THREAD_ID'
,
'DOTTED_ORDER'
,
'IS_ROOT'
,
'REFERENCE_EXAMPLE_ID'
,
'REFERENCE_DATASET_ID'
,
'TOTAL_TOKENS'
,
'PROMPT_TOKENS'
,
'COMPLETION_TOKENS'
,
'TOTAL_COST'
,
'PROMPT_COST'
,
'COMPLETION_COST'
,
'PROMPT_TOKEN_DETAILS'
,
'COMPLETION_TOKEN_DETAILS'
,
'PROMPT_COST_DETAILS'
,
'COMPLETION_COST_DETAILS'
,
'PRICE_MODEL_ID'
,
'TAGS'
,
'APP_PATH'
,
'ATTACHMENTS'
,
'THREAD_EVALUATION_TIME'
,
'IS_IN_DATASET'
,
'SHARE_URL'
,
'FEEDBACK_STATS'
]
]
|
Omit
=
omit
,
accept
:
str
|
Omit
=
omit
,
extra_headers
:
Headers
|
None
=
None
,
extra_query
:
Query
|
None
=
None
,
extra_body
:
Body
|
None
=
None
,
timeout
:
float
|
httpx
.
Timeout
|
None
|
NotGiven
=
not_given
)
->
TraceListRunsResponse

Parameters

NameTypeDescription
project_id*str

project_id is the UUID of the tracing project that owns the trace.

filterstr | Omit
Default:omit

filter narrows which runs within this trace are returned, using a LangSmith filter expression evaluated against each run. For example: eq(run_type, "llm") for LLM runs only, or eq(status, "error") for failed runs. See https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language for syntax.

max_start_timeUnion[str, datetime] | Omit
Default:omit
min_start_timeUnion[str, datetime] | Omit
Default:omit
selectsList[Literal['ID', 'NAME', 'RUN_TYPE', 'STATUS', 'START_TIME', 'END_TIME', 'LATENCY_SECONDS', 'FIRST_TOKEN_TIME', 'ERROR', 'ERROR_PREVIEW', 'EXTRA', 'METADATA', 'EVENTS', 'INPUTS', 'INPUTS_PREVIEW', 'OUTPUTS', 'OUTPUTS_PREVIEW', 'MANIFEST', 'PARENT_RUN_IDS', 'PROJECT_ID', 'TRACE_ID', 'THREAD_ID', 'DOTTED_ORDER', 'IS_ROOT', 'REFERENCE_EXAMPLE_ID', 'REFERENCE_DATASET_ID', 'TOTAL_TOKENS', 'PROMPT_TOKENS', 'COMPLETION_TOKENS', 'TOTAL_COST', 'PROMPT_COST', 'COMPLETION_COST', 'PROMPT_TOKEN_DETAILS', 'COMPLETION_TOKEN_DETAILS', 'PROMPT_COST_DETAILS', 'COMPLETION_COST_DETAILS'
extra_headersHeaders | None
Default:None
extra_queryQuery | None
Default:None
extra_bodyBody | None
Default:None
timeoutfloat | httpx.Timeout | None | NotGiven
Default:not_given

Alpha: The request and response contract may change; Returns runs for a trace ID within min/max start time. Optional filter; repeatable selects to select fields to return.

,
'PRICE_MODEL_ID'
,
'TAGS'
,
'APP_PATH'
,
'ATTACHMENTS'
,
'THREAD_EVALUATION_TIME'
,
'IS_IN_DATASET'
,
'SHARE_URL'
,
'FEEDBACK_STATS'
]] |
Omit
Default:omit

max_start_time is the optional inclusive upper bound for run start_time (RFC3339 date-time). Required together with min_start_time.

min_start_time is the optional inclusive lower bound for run start_time (RFC3339 date-time). Required together with max_start_time.

Send extra headers

Add additional query parameters to the request

Add additional JSON properties to the request

Override the client-level default timeout for this request, in seconds

selects lists which properties to include on each returned run (repeatable query parameter). Accepts any value of the RunSelectField enum. If omitted, only id is returned.